POST api/company/importPokud v request obsahuje údaj "id", při importu se dohledá záznam společnosti dle tohoto Id. Pokud nebude nalezen, import skončí chybou.
Pokud údaj Id v requestu není, nebo je null, pokusí se dohledat společnost dle externalId. Pokud není společnost nalezena, založí se nová.
import přes IČO:
POST api/company/import
Content-Type: application/json
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
{
"stateIdentNo":"65470896",
"currency": "CZK", // CZK, EUR, USD, ...
"externalId":"Company_ets4s",
"email":"import@test.com"
}
klasický import:
POST api/company/import
Content-Type: application/json
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
{
"name":"Test company 1",
"addressLine1":"Novohradská 22", // ulice
"city":"Brno",
"zip":"96895",
"country":"CZ", // iso 3361-1 alpha-2
"vatNumber":"CZ6454562", // DIČ
"email": "import@test.com",
"externalId":"Company_ets4s",
"currency": "CZK", // CZK, EUR, USD, ...
"id":2 // id záznamu společnosti vedené ve factorify
}
odpověď:
1030 // id společnosti
POST api/order/import-sales-orderimport:
POST api/order/import-sales-order
Content-Type: application/json
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
{
"projectCode":"554694SAD",
"projectName": "Název projektu",
"companyId":1,
"currency":"CZK",
"type":"ORDER",
"state":"NEW",
"amount":685.454,
"goodsId":1,
"dispatchDate":"2021-03-08",
"deliveryDate":"2021-03-08",
"sellerEmail":"jmeno@firma.cz"
}
odpověď:
1030 // id prodejní objednávky
GET api/order/sales-orders/{timestamp}GET api/order/sales-orders/1633075804000
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
Odpověď
[
{
"id": 1030, // id objednávky
"currency": "CZK",
"type": "ORDER", // typ objednávky
"state": "NEW", // stav objednávky
"totalPrice": 685.454, // celková suma všech položek objednávky
"deliveryDate": "2021-10-02", // požadované datum dodání
"dispatchDate": "2021-10-27", // požadované datum expedice
"projectId": "39", // id projektu
"projectCode": "554694SAD", // kód projektu
"customerId": 21 // id zákazníka
}
]
Endpoint pro účetní doklady vázané na prodejní objednávky
GET api/eshop/accounting-documents/{timestamp}Endpoint pro účetní doklady vázané na projekty
GET api/eshop/accounting-documents-with-project/{timestamp}GET api/eshop/accounting-documents/1633075804000
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
Odpověď
{
"accountingDocuments": [
{
"createdAt": "2021-12-02 09:53",
"updatedAt": "2021-12-02 09:54",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 10590, // id faktury
"version": 2,
"documentNumber": "210400059", // číslo dokladu
"accountingDocumentType": {
"id": 16,
"referenceName": "Faktura vydaná - CZK ostatní",
"type": "INVOICE",
"direction": "ISSUED",
"filterCompanyType": null,
"filterCompany": true,
"requireCounterparty": true,
"requireReceivedDocumentNumber": false,
"requireVariableSymbol": true,
"editableVariableSymbol": false,
"editableDocumentNumber": false,
"advanceTaxDocument": false,
"paymentDirection": "CREDIT"
},
"state": {
"class": "me.factorify.server.accounting.AccountingDocumentState",
"createdAt": "2021-07-18 17:09",
"updatedAt": "2021-10-29 15:19",
"updatedBy": {
"id": 8,
"referenceName": "Karel Šebela",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 1,
"code": "NEW",
"label": {
"1": "New",
"2": "Nový "
},
"isDefault": true,
"active": true,
"processed": false,
"payable": false,
"translatedLabel": "Nový ",
"referenceName": "1"
},
"myAddress": {
"createdAt": "2021-02-26 21:42",
"updatedAt": "2021-07-26 16:28",
"createdBy": {
"id": 8,
"referenceName": "Karel Šebela",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 8,
"referenceName": "Karel Šebela",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 18,
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
},
"isDefault": true,
"type": "BILLING_ADDRESS",
"name": "MILT CZ ",
"addressLine1": "Vinohradská 2165/48",
"city": "Praha",
"zip": "12000",
"country": {
"id": 55,
"referenceName": "Česká republika"
},
"vatPayer": true,
"vatNo": "CZ27620182",
"stateIdentNo": "27620182",
"state": "NEW",
"addressLine": "Vinohradská 2165/48",
"referenceName": "MILT CZ , Vinohradská 2165/48, Praha, 12000, Česká republika, CZ27620182"
},
"vatProcessing": {
"createdAt": "2021-10-18 12:05",
"updatedAt": "2021-10-18 12:05",
"createdBy": {
"id": 7,
"referenceName": "Pavlína Mullerová",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 7,
"referenceName": "Pavlína Mullerová",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 14,
"startDate": "2021-12-01",
"endDate": "2021-12-31",
"state": "OPEN",
"address": {
"createdAt": "2021-02-26 21:42",
"updatedAt": "2021-07-26 16:28",
"createdBy": {
"id": 8,
"referenceName": "Karel Šebela",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 8,
"referenceName": "Karel Šebela",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 18,
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
},
"isDefault": true,
"type": "BILLING_ADDRESS",
"name": "MILT CZ ",
"addressLine1": "Vinohradská 2165/48",
"city": "Praha",
"zip": "12000",
"country": {
"id": 55,
"referenceName": "Česká republika"
},
"vatPayer": true,
"vatNo": "CZ27620182",
"stateIdentNo": "27620182",
"state": "NEW",
"addressLine": "Vinohradská 2165/48",
"referenceName": "MILT CZ , Vinohradská 2165/48, Praha, 12000, Česká republika, CZ27620182"
},
"referenceName": "14"
},
"variableSymbol": "210400059",
"vatCountry": {
"id": 55,
"referenceName": "Česká republika"
},
"vatBreakdown": {
"id": 3,
"referenceName": "Uskutečněné tuzemské plnění",
"type": "REGULAR"
},
"manualVatBreakdown": false,
"issueDate": "2021-12-02", // datum vystavení
"accountingEntryDate": "2021-12-02",
"taxPointDate": "2021-12-02", // datum zanitelného plnění
"counterpartyTaxPointDate": "2021-12-02",
"accruals": [],
"freeAttributes": {
"INVOICE_CONFIRM": false
},
"address": { // fakturační adresa
"id": 1141,
"referenceName": "EQUIP-TEST s.r.o., Slovákova 357/8, Brno, 60200, Česká republika, CZ27685501",
"company": { // společnost - fakturační
"id": 1053,
"referenceName": "EQUIP-TEST s.r.o.",
"currency": null
},
"externalId": null
},
"deliveryAddress": { // doručovací adresa
"id": 1141,
"referenceName": "EQUIP-TEST s.r.o., Slovákova 357/8, Brno, 60200, Česká republika, CZ27685501",
"company": { // společnosti - doručovací
"id": 1053,
"referenceName": "EQUIP-TEST s.r.o.",
"currency": null
},
"externalId": null
},
"currency": "CZK", // měna
"dueDate": "2021-12-16", // datum splatnosti
"counterpartyAccountNumber": "4200077203",
"counterpartyBankCode": "6800",
"paymentMethod": "WIRE_TRANSFER",
"taxes": [
{
"createdAt": "2021-12-02 09:53",
"updatedAt": "2021-12-02 09:54",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 72701,
"accountingDocument": {
"id": 10590,
"referenceName": "210400059",
"currency": "CZK",
"externalId": null,
"totalAmountTaxIncluded": 605.0,
"totalAmountDomesticTaxIncluded": 605.0,
"reconciledAmount": 0.0,
"notReconciled": 605.0
},
"valueAddedTax": {
"id": 1,
"referenceName": "0 %",
"rateType": "ZERO_RATE",
"ratePct": 0.0
},
"base": 0.0,
"tax": 0.0,
"currencyId": "CZK",
"deleted": false,
"referenceName": "72701"
},
{
"createdAt": "2021-12-02 09:53",
"updatedAt": "2021-12-02 09:54",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 72702,
"accountingDocument": {
"id": 10590,
"referenceName": "210400059",
"currency": "CZK",
"externalId": null,
"totalAmountTaxIncluded": 605.0,
"totalAmountDomesticTaxIncluded": 605.0,
"reconciledAmount": 0.0,
"notReconciled": 605.0
},
"valueAddedTax": {
"id": 2,
"referenceName": "10 %",
"rateType": "REDUCED_RATE_2",
"ratePct": 10.0
},
"base": 0.0,
"tax": 0.0,
"currencyId": "CZK",
"deleted": false,
"referenceName": "72702"
},
{
"createdAt": "2021-12-02 09:53",
"updatedAt": "2021-12-02 09:54",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 72703,
"accountingDocument": {
"id": 10590,
"referenceName": "210400059",
"currency": "CZK",
"externalId": null,
"totalAmountTaxIncluded": 605.0,
"totalAmountDomesticTaxIncluded": 605.0,
"reconciledAmount": 0.0,
"notReconciled": 605.0
},
"valueAddedTax": {
"id": 3,
"referenceName": "15 %",
"rateType": "REDUCED_RATE_1",
"ratePct": 15.0
},
"base": 0.0,
"tax": 0.0,
"currencyId": "CZK",
"deleted": false,
"referenceName": "72703"
},
{
"createdAt": "2021-12-02 09:53",
"updatedAt": "2021-12-02 09:54",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 72704,
"accountingDocument": {
"id": 10590,
"referenceName": "210400059",
"currency": "CZK",
"externalId": null,
"totalAmountTaxIncluded": 605.0,
"totalAmountDomesticTaxIncluded": 605.0,
"reconciledAmount": 0.0,
"notReconciled": 605.0
},
"valueAddedTax": {
"id": 4,
"referenceName": "21 %",
"rateType": "BASIC_RATE",
"ratePct": 21.0
},
"base": 500.0,
"tax": 105.0,
"currencyId": "CZK",
"deleted": false,
"referenceName": "72704"
}
],
"items": [
{ // první položka faktury
"createdAt": "2021-12-02 09:53",
"updatedAt": "2021-12-02 09:54",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 72705, // id položky
"accountingDocument": {
"id": 10590, // id faktury
"referenceName": "210400059", // číslo dokladu
"currency": "CZK",
"externalId": null,
"totalAmountTaxIncluded": 605.0,
"totalAmountDomesticTaxIncluded": 605.0,
"reconciledAmount": 0.0,
"notReconciled": 605.0
},
"name": "3D-14 Vložka do Glazma dlouhá Levá/Pravá", // název položky
"note": "" // popis položky
"goods": {
"id": 438,
"referenceName": "3D-14 Vložka do Glazma dlouhá Levá/Pravá",
"nonStock": false,
"type": {
"id": 10,
"referenceName": "3D tisk",
"vatClassification": {
"id": 21,
"referenceName": "Ostatní zboží"
},
"alternativeUnit2": null
},
"unit": "pc",
"distinguishBatches": false,
"perishable": false,
"expirationMonths": null
},
"quantity": 1.0, // množství
"unit": "pc",
"unitPrice": 200.0, // cena za jednotku
"unitPriceIncludesVat": false,
"pricePerUnitDomestic": 200.0,
"valueAddedTax": {
"id": 4,
"referenceName": "21 %",
"rateType": "BASIC_RATE",
"ratePct": 21.0
},
"stockMoves": [],
"batchWorkEvidence": [],
"project": {
"id": 1148, // id projektu
"referenceName": "test projekt EQUIP"
},
"deleted": false,
"totalPrice": 200.0, // celková cena položky
"saleRatio": 1.0,
"totalPriceWithVat": 242.0, //celková cena položky včetně DPH
"vat": 42.0,
"discountedUnitPrice": 200.0,
"vatRatePct": 21.0,
"referenceName": "3D-14 Vložka do Glazma dlouhá Levá/Pravá"
},
{ // druhá položka faktury
"createdAt": "2021-12-02 09:53",
"updatedAt": "2021-12-02 09:54",
"createdBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 1,
"referenceName": "Admin Admin",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 72706,
"accountingDocument": {
"id": 10590,
"referenceName": "210400059",
"currency": "CZK",
"externalId": null,
"totalAmountTaxIncluded": 605.0,
"totalAmountDomesticTaxIncluded": 605.0,
"reconciledAmount": 0.0,
"notReconciled": 605.0
},
"name": "3D-66 Vložka ke střelce pro WOOD zárubeň MILT",
"goods": {
"id": 671,
"referenceName": "3D-66 Vložka ke střelce pro WOOD zárubeň MILT",
"nonStock": false,
"type": {
"id": 10,
"referenceName": "3D tisk",
"vatClassification": {
"id": 21,
"referenceName": "Ostatní zboží"
},
"alternativeUnit2": null
},
"unit": "pc",
"distinguishBatches": false,
"perishable": false,
"expirationMonths": null
},
"quantity": 1.0,
"unit": "pc",
"unitPrice": 300.0,
"unitPriceIncludesVat": false,
"pricePerUnitDomestic": 300.0,
"valueAddedTax": {
"id": 4,
"referenceName": "21 %",
"rateType": "BASIC_RATE",
"ratePct": 21.0
},
"stockMoves": [],
"batchWorkEvidence": [],
"project": {
"id": 1148,
"referenceName": "test projekt EQUIP"
},
"deleted": false,
"totalPrice": 300.0,
"saleRatio": 1.0,
"totalPriceWithVat": 363.0,
"vat": 63.0,
"discountedUnitPrice": 300.0,
"vatRatePct": 21.0,
"referenceName": "3D-66 Vložka ke střelce pro WOOD zárubeň MILT"
}
],
"roundingDifference": 0.0,
"manualRoundingDifference": false,
"manualVat": false,
"totalAmountTaxExcluded": 500.0,
"totalAmountTaxIncluded": 605.0,
"totalAmountDomesticTaxExcluded": 500.0,
"totalAmountDomesticTaxIncluded": 605.0,
"paidAmountTaxExcluded": 0.0,
"reconciledAmount": 0.0, // uhrazená částka
"manuallyReconciled": false,
"reconciled": false,
"notReconciled": 605.0,
"appliedAmount": 0.0,
"sequence": 59,
"attachments": [],
"deleted": false,
"unreliableVatPayer": false,
"unverifiedBankAccount": false,
"reliabilityVerificationFailed": false,
"countToHandicappedEmploymentRate": false,
"issuedCreditNote": false,
"amountToReconcile": 605.0, // částka k úhradě
"taxPointAddress": {
"createdAt": "2021-12-01 19:37",
"updatedAt": "2021-12-01 19:37",
"createdBy": {
"id": 77,
"referenceName": "Sales Force",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"updatedBy": {
"id": 77,
"referenceName": "Sales Force",
"company": {
"id": 1,
"referenceName": "MILT s.r.o.",
"currency": "CZK"
}
},
"id": 1141,
"company": {
"id": 1053,
"referenceName": "EQUIP-TEST s.r.o.",
"currency": null
},
"isDefault": true,
"type": "BILLING_ADDRESS",
"addressLine1": "Slovákova 357/8",
"city": "Brno",
"zip": "60200",
"country": {
"id": 55,
"referenceName": "Česká republika"
},
"vatPayer": true,
"vatNo": "CZ27685501",
"stateIdentNo": "27685501",
"state": "NEW",
"addressLine": "Slovákova 357/8",
"referenceName": "EQUIP-TEST s.r.o., Slovákova 357/8, Brno, 60200, Česká republika, CZ27685501"
},
"vatClassification": {
"createdAt": "2021-02-25 10:41",
"updatedAt": "2021-02-25 10:41",
"id": 21,
"version": 0,
"name": {
"2": "Ostatní zboží"
},
"validFrom": "2020-12-01",
"referenceName": "Ostatní zboží"
},
"exchangeRateSafely": 1.0,
"referenceName": "210400059"
}
],
"totalCount": 1
}
POST api/opportunity/importimport:
POST api/opportunity/import
Content-Type: application/json
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
{
"title": "příležitost 111",
"type": "DEAL", // dle číselníku DEAL_TYPES
"note": "poznámka"
"currency":"CZK", // CZK, EUR, USD, ...
"customer": {
// pokud není id uvedeno, založí se nový zákazník s údaji z dalších políček
// pokud je id uvedeno, další políčka se ignorují
"id": 123,
"name": "jméno zákazníka",
"phone": "+420 123 456 789",
"email": "jmeno@firma.cz",
"note" : "poznámka"
}
}
odpověď:
2 // id obchodní příležitosti
POST api/offer/importimport:
POST api/offer/import
Content-Type: application/json
Accept: application/json
Cookie: securityToken=CARD:cf35476ee6ed7359ea67b5f7e96e3126
X-FySerialization: ui2
{
"externalId": "EX-01-23435423", // externí id v jiné aplikaci
"offerNumber": "NAB-2023-001-123" // číslo nabídky
"type": "OFFER", // dle číselníku OFFER_TYPES
"note": "poznámka"
"currency":"CZK", // CZK, EUR, USD, ...
"opportunityId": 2, // id obchodní příležitosti (nepovinné)
"items": {
"name": "název položky",
"quantity": 10, // množství
"unitPrice": 10.50, // cena jedné položky (nepovinné)
"goodsId": 111, // id zboží (má přednost před externím id zboží)
"goodsExternalId": "G-12345" // externí id zboží
// alespoň jedno z goodsId, goodsExternalId je povinné
}
}
odpověď:
2 // id nabídky