Przykład PostingInstruction (zasób bufora dokumentu)
URL systemów kodów: https://api-erp.kamsoft.pl/vs/fkw/ (posting-instruction-document-symbol-type, posting-instruction-line-type itd.). Rodzaj identyfikatora wynika z Identifier.system (np. https://gov.pl/nip, https://gov.pl/regon).
Wymagania
- Identyfikator - id bufora dokumentu (system dowolny),
- Identyfikator - numer dokumentu (https://api-erp.kamsoft.pl/vs/document-number)
- Owner - NIP (https://gov.pl/nip)
- IssueDate - data wystawienia dokumentu
- Symbol - symbol dokumentu (https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-symbol)
- Symbol - symbol typu dokumentu (https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-document-symbol-type)
{
"identifier": [
{
"type": {
"text": "Id faktury"
},
"system": "urn:oid:1.2.616.1.113769.4.1.1.899566.215361.91",
"value": "EKS17"
},
{
"type": {
"text": "Numer faktury"
},
"system": "https://api-erp.kamsoft.pl/vs/document-number",
"value": "123456789"
},
{
"type": {
"text": "KSeF number"
},
"system": "https://ksef.podatki.gov.pl",
"value": "9999999999-RRRRMMDD-FFFFFFFFFFFF-FF"
}
],
"participant": [
{
"type": "Party",
"identifier": {
"system": "urn:oid:1.2.616.1.113769.4.1.1.899566.215361.65",
"value": "7"
}
}
],
"attachment": [],
"issueDate": "2026-02-09",
"realizationDate": "2026-02-09",
"symbol": [
{
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-symbol",
"code": "123"
}
]
},
{
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-document-symbol-type",
"code": "123"
}
]
}
],
"paymentMethod": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/payment-method",
"code": "T"
}
]
},
"accountingVariant": {
"type": "AccountingVariant",
"identifier": {
"system": "urn:oid:1.2.616.1.113769.4.1.1.899566.215361.70",
"value": "1"
}
},
"grossAmount": {
"value": 300.0,
"currency": "PLN"
},
"netAmount": {
"value": 300.0,
"currency": "PLN"
},
"vatAmount": {
"value": 0.0,
"currency": "PLN"
},
"register": {
"type": "Register",
"identifier": {
"system": "urn:oid:1.2.616.1.113769.4.1.1.899566.215361.83",
"value": "1"
}
},
"saleDate": "2026-02-10",
"dueDate": "2026-02-11",
"accountingDate": "2026-02-09",
"paymentAccount": {
"type": "BankAccount",
"identifier": {
"system": "urn:oid:1.2.616.1.113769.4.1.1.899566.215361.79",
"value": "65 4321 1234 5678 8765 8998 9999"
}
},
"position": [
{
"positionNo": 1,
"code": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-line-type",
"code": "accounting-item"
}
]
},
"value": [
{
"type": {
"text": "net"
},
"valueMoney": {
"value": 100.0,
"currency": "PLN"
}
},
{
"type": {
"text": "vat"
},
"valueMoney": {
"value": 0.0,
"currency": "PLN"
}
},
{
"type": {
"coding": [],
"text": "gross"
},
"valueMoney": {
"value": 100.0,
"currency": "PLN"
}
},
{
"type": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-line-value-item-type",
"code": "amount"
}
],
"text": "amount"
},
"valueMoney": {
"value": 100,
"currency": "PLN"
}
}
],
"allocation": {
"type": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-allocation-item-type",
"code": "KR"
}
]
},
"formulaComponent": {
"type": "FormulaComponent",
"identifier": {
"type": {
"text": "Formula component number"
},
"system": "urn:oid:1.2.616.1.113769.4.1.1.899566.215361.71.1",
"value": "402-01-05"
}
}
},
"vatRate": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/vat-rate",
"code": "23"
}
]
},
"description": "opis testowy",
"accountingVariant": {
"reference": null,
"type": null,
"identifier": {
"system": "urn:oid:1.2.616.1.113769.4.1.1.899566.215361.70",
"value": "1"
}
}
},
{
"positionNo": 2,
"code": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-line-type",
"code": "accounting-item"
}
]
},
"value": [
{
"type": {
"text": "net"
},
"valueMoney": {
"value": 100.0,
"currency": "PLN"
}
},
{
"type": {
"text": "vat"
},
"valueMoney": {
"value": 0.0,
"currency": "PLN"
}
},
{
"type": {
"text": "gross"
},
"valueMoney": {
"value": 100.0,
"currency": "PLN"
}
},
{
"type": {
"text": "quantity"
},
"valueQuantity": {
"value": 2.0
}
},
{
"type": {
"text": "unitPrice"
},
"valueMoney": {
"value": 50.0,
"currency": "PLN"
}
},
{
"type": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-line-value-item-type",
"code": "amount"
}
],
"text": "amount"
},
"valueMoney": {
"value": 100,
"currency": "PLN"
}
}
],
"allocation": {
"type": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-allocation-item-type",
"code": "KO"
}
]
},
"formulaComponent": {
"type": "FormulaComponent",
"identifier": {
"type": {
"text": "Formula component number"
},
"system": "urn:oid:1.2.616.1.113769.4.1.1.899566.215361.71.1",
"value": "500-02"
}
}
},
"vatRate": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/vat-rate",
"code": "23"
}
]
},
"description": "opis testowy2",
"accountingVariant": {
"type": "AccountingVariant",
"identifier": {
"system": "urn:oid:1.2.616.1.113769.4.1.1.899566.215361.70",
"value": "2"
}
}
}
],
"owner": [
{
"identifier": {
"type": {
"text": "NIP"
},
"system": "https://gov.pl/nip",
"value": "0123456789"
}
}
],
"comment": "Test",
"type": {
"coding": [
{
"system": "https://api-erp.kamsoft.pl/vs/fkw/posting-instruction-type",
"code": "invoice"
}
]
}
}