POST B2BInvoice
Accepts an invoice record for a given Supplier. Used by Invoice Capture Screens as part of B2B project.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| userName |
Username for Account to be used for Authentication/Authorization |
string |
Required |
| password |
Password for Account to be used for Authentication/Authorization |
string |
Required |
| internalUser | boolean |
Default value is False |
Body Parameters
Invoice to Insert
InvoiceHeaderViewModel| Name | Description | Type | Additional information |
|---|---|---|---|
| HeaderVersion | string |
String length: inclusive between 0 and 50 |
|
| SenderEAN | string |
String length: inclusive between 0 and 15 |
|
| ReceiverEAN | string |
String length: inclusive between 0 and 15 |
|
| InvoiceRefNo | globally unique identifier |
None. |
|
| Standard | string |
String length: inclusive between 0 and 50 |
|
| TypeVersion | string |
String length: inclusive between 0 and 50 |
|
| InstanceIdentifier | string |
String length: inclusive between 0 and 50 |
|
| InvoiceType | string |
String length: inclusive between 0 and 50 |
|
| MultipleType | string |
String length: inclusive between 0 and 50 |
|
| DocumentCreationDatetime | date |
None. |
|
| MessageId | string |
String length: inclusive between 0 and 50 |
|
| ContentOwnerGLN | string |
String length: inclusive between 0 and 20 |
|
| CommandType | string |
String length: inclusive between 0 and 50 |
|
| CommandOwnerGLN | string |
String length: inclusive between 0 and 20 |
|
| DocumentStatus | string |
String length: inclusive between 0 and 50 |
|
| ContentVersion | string |
String length: inclusive between 0 and 10 |
|
| DocumentVersion | string |
String length: inclusive between 0 and 10 |
|
| DocumentNumber | string |
String length: inclusive between 0 and 50 |
|
| CurrencyISOCode | string |
String length: inclusive between 0 and 10 |
|
| Type | string |
String length: inclusive between 0 and 50 |
|
| CountryISOCode | string |
String length: inclusive between 0 and 10 |
|
| BuyerGLN | string |
String length: inclusive between 0 and 20 |
|
| SellerGLN | string |
String length: inclusive between 0 and 20 |
|
| ShipToGLN | string |
String length: inclusive between 0 and 20 |
|
| VATRegistrationNumber | string |
String length: inclusive between 0 and 20 |
|
| DocumentTotalExVAT | decimal number |
None. |
|
| DocumentTotalInclVAT | decimal number |
None. |
|
| DocumentTotalVAT | decimal number |
None. |
|
| OrderNumber | integer |
None. |
|
| PurchaseOrder | string |
String length: inclusive between 0 and 25 |
|
| InvoiceDate | date |
None. |
|
| InvoiceNumber | string |
String length: inclusive between 0 and 20 |
|
| InvoiceDetails | Collection of InvoiceDetailLineViewModel |
None. |
Request Formats
application/json, text/json
{
"HeaderVersion": "3.2.0",
"SenderEAN": "70564",
"ReceiverEAN": "6001001018104",
"InvoiceRefNo": "0da90e97-0501-4f1d-bca9-b3b0d325cef4",
"Standard": "EDI 3.2.0",
"TypeVersion": "3.2.0",
"InstanceIdentifier": "-447140579",
"InvoiceType": "INVOICE",
"MultipleType": null,
"DocumentCreationDatetime": "2025-12-14T18:16:40.2318881+02:00",
"MessageId": "639013330002318881",
"ContentOwnerGLN": "Supplier GLN",
"CommandType": "ADD",
"CommandOwnerGLN": "Supplier GLN",
"DocumentStatus": "ORIGINAL",
"ContentVersion": "3.2.0",
"DocumentVersion": "1.0",
"DocumentNumber": "DocNum",
"CurrencyISOCode": "ZAR",
"Type": "Invoice",
"CountryISOCode": "ZA",
"BuyerGLN": "6001001018104",
"SellerGLN": "Supplier GLN",
"ShipToGLN": "6001001018104",
"VATRegistrationNumber": "VAT Reg No",
"DocumentTotalExVAT": 526.68,
"DocumentTotalInclVAT": 462.0,
"DocumentTotalVAT": 64.68,
"OrderNumber": 102019601,
"PurchaseOrder": "102019601",
"InvoiceDate": "2025-12-19T18:16:40.2318881+02:00",
"InvoiceNumber": "Invoice_Num",
"InvoiceDetails": [
{
"InvoiceDetailRefNo": "de2c9637-5e64-455d-94ba-8a70015d4cef",
"InvoiceRefNo": "0da90e97-0501-4f1d-bca9-b3b0d325cef4",
"LineNumber": 1,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-12-14T00:00:00",
"CostPrice": 231.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 263.34,
"TaxFeeType": "VAT",
"TaxAmount": 32.34
},
{
"InvoiceDetailRefNo": "8bc31a49-0fd7-406f-85a1-ef1878d274ec",
"InvoiceRefNo": "0da90e97-0501-4f1d-bca9-b3b0d325cef4",
"LineNumber": 2,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-12-14T00:00:00",
"CostPrice": 231.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 263.34,
"TaxFeeType": "VAT",
"TaxAmount": 32.34
}
]
}
application/x-www-form-urlencoded
Sample not available.
Response Information
Resource Description
An invoice record with an HTTP 200, or null with the relevant HTTP error code.
InvoiceHeaderViewModel| Name | Description | Type | Additional information |
|---|---|---|---|
| HeaderVersion | string |
String length: inclusive between 0 and 50 |
|
| SenderEAN | string |
String length: inclusive between 0 and 15 |
|
| ReceiverEAN | string |
String length: inclusive between 0 and 15 |
|
| InvoiceRefNo | globally unique identifier |
None. |
|
| Standard | string |
String length: inclusive between 0 and 50 |
|
| TypeVersion | string |
String length: inclusive between 0 and 50 |
|
| InstanceIdentifier | string |
String length: inclusive between 0 and 50 |
|
| InvoiceType | string |
String length: inclusive between 0 and 50 |
|
| MultipleType | string |
String length: inclusive between 0 and 50 |
|
| DocumentCreationDatetime | date |
None. |
|
| MessageId | string |
String length: inclusive between 0 and 50 |
|
| ContentOwnerGLN | string |
String length: inclusive between 0 and 20 |
|
| CommandType | string |
String length: inclusive between 0 and 50 |
|
| CommandOwnerGLN | string |
String length: inclusive between 0 and 20 |
|
| DocumentStatus | string |
String length: inclusive between 0 and 50 |
|
| ContentVersion | string |
String length: inclusive between 0 and 10 |
|
| DocumentVersion | string |
String length: inclusive between 0 and 10 |
|
| DocumentNumber | string |
String length: inclusive between 0 and 50 |
|
| CurrencyISOCode | string |
String length: inclusive between 0 and 10 |
|
| Type | string |
String length: inclusive between 0 and 50 |
|
| CountryISOCode | string |
String length: inclusive between 0 and 10 |
|
| BuyerGLN | string |
String length: inclusive between 0 and 20 |
|
| SellerGLN | string |
String length: inclusive between 0 and 20 |
|
| ShipToGLN | string |
String length: inclusive between 0 and 20 |
|
| VATRegistrationNumber | string |
String length: inclusive between 0 and 20 |
|
| DocumentTotalExVAT | decimal number |
None. |
|
| DocumentTotalInclVAT | decimal number |
None. |
|
| DocumentTotalVAT | decimal number |
None. |
|
| OrderNumber | integer |
None. |
|
| PurchaseOrder | string |
String length: inclusive between 0 and 25 |
|
| InvoiceDate | date |
None. |
|
| InvoiceNumber | string |
String length: inclusive between 0 and 20 |
|
| InvoiceDetails | Collection of InvoiceDetailLineViewModel |
None. |
Response Formats
application/json, text/json
{
"HeaderVersion": "3.2.0",
"SenderEAN": "70564",
"ReceiverEAN": "6001001018104",
"InvoiceRefNo": "0da90e97-0501-4f1d-bca9-b3b0d325cef4",
"Standard": "EDI 3.2.0",
"TypeVersion": "3.2.0",
"InstanceIdentifier": "-447140579",
"InvoiceType": "INVOICE",
"MultipleType": null,
"DocumentCreationDatetime": "2025-12-14T18:16:40.2318881+02:00",
"MessageId": "639013330002318881",
"ContentOwnerGLN": "Supplier GLN",
"CommandType": "ADD",
"CommandOwnerGLN": "Supplier GLN",
"DocumentStatus": "ORIGINAL",
"ContentVersion": "3.2.0",
"DocumentVersion": "1.0",
"DocumentNumber": "DocNum",
"CurrencyISOCode": "ZAR",
"Type": "Invoice",
"CountryISOCode": "ZA",
"BuyerGLN": "6001001018104",
"SellerGLN": "Supplier GLN",
"ShipToGLN": "6001001018104",
"VATRegistrationNumber": "VAT Reg No",
"DocumentTotalExVAT": 526.68,
"DocumentTotalInclVAT": 462.0,
"DocumentTotalVAT": 64.68,
"OrderNumber": 102019601,
"PurchaseOrder": "102019601",
"InvoiceDate": "2025-12-19T18:16:40.2318881+02:00",
"InvoiceNumber": "Invoice_Num",
"InvoiceDetails": [
{
"InvoiceDetailRefNo": "de2c9637-5e64-455d-94ba-8a70015d4cef",
"InvoiceRefNo": "0da90e97-0501-4f1d-bca9-b3b0d325cef4",
"LineNumber": 1,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-12-14T00:00:00",
"CostPrice": 231.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 263.34,
"TaxFeeType": "VAT",
"TaxAmount": 32.34
},
{
"InvoiceDetailRefNo": "8bc31a49-0fd7-406f-85a1-ef1878d274ec",
"InvoiceRefNo": "0da90e97-0501-4f1d-bca9-b3b0d325cef4",
"LineNumber": 2,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-12-14T00:00:00",
"CostPrice": 231.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 263.34,
"TaxFeeType": "VAT",
"TaxAmount": 32.34
}
]
}