- url: POST /api/import-sales-orders
- vstupní data: seznam prodejních objednávek
POST api/import-sales-orders
Content-Type: application/json
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
[
{
"orderNumber": "", // string, číslo objednávky
"externalId": "", // string, externí Id (v eshopu)
"languageCode": "cs", // string, nepovinné, jazyk
"state": "NEW", // string, stav objednávky, číselník (NEW, CANCELLED, CONFIRMED, ...)
"type": "ESHOP", // string, vyžadováno, typ objednávky dle číselníku
"paymentMethod": "", // string, platební metoda, číselník
"receivedAt": "2021-01-01", // string, LocalDate, vyžadováno; na tuto hodnotu se nastaví i datumy odeslání a doručení (s případnou změnou dle dodací lhůty na zboží)
"transporterId": 1, // long, nepovinné, id přepravní společnosti
"transportConditions":"", // string, nepovinné, přepravní podmínky, číselník
"singleDelivery": true, // boolean, nepovinné, výchozí true, všechny položky poslat najednou
"customer": { // vyžadováno, zákazník, pokud neexistuje bude založen nový, existujícímu budou upraveny údaje (název, email)
"externalId": "eshop-ZAK-0001", // string, párovací identifikátor
"name": "Zákazník, s.r.o.", // string
"email": "info@zakaznik.cz" // string
},
"deliveryAddress": { // vyžadováno, Address
"externalId": "", // string, vyžadováno, externí Id (eshop)
"city": "", // string, vyžadováno
"addressLine1": "", // string, vyžadováno
"addressLine2": "", // string
"addressLine3": "", // string
"responsiblePersonName": "", // string
"zip": "", // string, vyžadováno
"phone": "", // string
"countryCode": "CZ", // vyžadováno
"stateCode": "", // string
"stateIdentNo": "", // string, IČO
"vatNo": "", // string, DIČ
"name": "", // string, uživ. název adresy
"isVatPayer": true // boolean, plátce DPH
},
"billingAddress": { // vyžadováno, Address
"externalId": "", // string, vyžadováno, externí Id (eshop)
"city": "", // string, vyžadováno
"addressLine1": "", // string, vyžadováno
"addressLine2": "", // string
"addressLine3": "", // string
"responsiblePersonName": "", // string
"zip": "", // string, vyžadováno
"phone": "", // string
"countryCode": "CZ", // vyžadováno
"stateCode": "", // string
"stateIdentNo": "", // string, IČO
"vatNo": "", // string, DIČ
"name": "", // string, uživ. název adresy
"isVatPayer": true // boolean, plátce DPH
},
"currency": "CZK", // string, kód měny
"note": "poznámka k objednávce", // string
"deliveryBranchId": 2, // long, nepovinné
"items": [ // pole položek objednávky
{
"goodsId": 1124, // long, id zboží (má přednost před code)
"goodsCode": "", // string, code zboží (má přednost před externalId)
"goodsExternalId": "", // string, externalId zboží, alespoň jedno (id, code, externalId) musí být uvedeno
"note": "poznámka položky 1", // string
"name": "název položky 1", // string
"quantity": 2.0, // double, množství
"price": 112.4, // double, cena bez dph
"vatRatePct": 21, // long, sazba DPH
"variants": [ // pole, varianty zboží (nepovinné)
"varianta1", // string
"varianta2" // string
]
},
{
"goodsId": 2244,
"note": "poznámka položky 2",
"name": "název položky 2",
"quantity": 10.0,
"price": 34.0,
"vatRatePct": 21
}
]
},
{
... další prodejní objednávka
}
]
- v agendě společností u daného přepravce je potřeba nastavit API přepravce
- je potřeba posílat deliveryBranchId a také responsiblePersonName
- API přepravce je Packetery
- url: GET /api/company/export
- vrací: seznam společností a jejich skupiny (slevy)
GET api/company/export
Content-Type: application/json
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
[
{
"createdAt": "2021-10-15 09:28",
"updatedAt": "2022-01-31 23:09",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"id": 3,
"version": 2,
"name": "Factorify, s. r. o.",
"companyGroupIds": [
{
"id": 1,
"referenceName": "sleva 10"
},
{
"id": 2,
"referenceName": "sleva 20"
}
],
"types": [
"CUSTOMER",
"SUPPLIER"
],
"state": "NEW",
"currencyId": "CZK",
"personalPickup": false,
"plannedLoading": false,
"neverCombineOrders": false,
"attachments": [],
"vipCustomer": false,
"penaltyPerHour": 0,
"allowMultipleVariantsOnPallet": false,
"freeAttributes": {},
"addresses": [],
"contacts": [
{
"createdAt": "2021-10-15 09:28",
"updatedAt": "2022-01-31 23:09",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"id": 4,
"company": {
"id": 3,
"referenceName": "Factorify, s. r. o.",
"currency": "CZK"
},
"type": "EMAIL",
"value": "info@factorify.cz",
"referenceName": "info@factorify.cz"
}
],
"bankAccounts": [
{
"createdAt": "2021-10-15 09:28",
"updatedAt": "2022-01-31 23:09",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"id": 1,
"company": {
"id": 3,
"referenceName": "Factorify, s. r. o.",
"currency": "CZK"
},
"number": "1930051044",
"bankCode": "5500",
"bankAccountNumber": "1930051044/5500",
"isDefault": false,
"referenceName": "#1 1930051044 "
}
],
"firstEmail": {
"createdAt": "2021-10-15 09:28",
"updatedAt": "2022-01-31 23:09",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"id": 4,
"company": {
"id": 3,
"referenceName": "Factorify, s. r. o.",
"currency": "CZK"
},
"type": "EMAIL",
"value": "info@factorify.cz",
"referenceName": "info@factorify.cz"
},
"unique": false,
"referenceName": "Factorify, s. r. o.",
"companyGroups": [
{
"createdAt": "2022-01-18 16:20",
"updatedAt": "2022-01-18 16:20",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"id": 2,
"version": 1,
"name": {
"2": "sleva 20"
},
"globalSale": 20.0,
"freeAttributes": {},
"sales": [],
"referenceName": "sleva 20"
},
{
"createdAt": "2022-01-18 16:20",
"updatedAt": "2022-01-18 16:20",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "This Company",
"currency": "CZK"
}
},
"id": 1,
"version": 1,
"name": {
"2": "sleva 10"
},
"globalSale": 10.0,
"freeAttributes": {},
"sales": [],
"referenceName": "sleva 10"
}
]
},
{
... další společnost
}
]
- url: GET /api/eshop/stock-supplies
- vrací: seznam zboží (id, kód, množství skladem)
GET api/eshop/stock-supplies
Content-Type: application/json
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
[
{
"id": 87, // id zboží
"code": "1100084", // kód zboží
"quantity": 0.0, // množství skladem
"dispatchWeightKg": 0.2 // váha zboží (netto) [kg]
},
{
"id": 184,
"code": "1100182",
"quantity": 10.0,
"dispatchWeightKg": 1.3
},
...
]