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": "a0610cd9-1135-477e-a990-93843da5cf18",
"Standard": "EDI 3.2.0",
"TypeVersion": "3.2.0",
"InstanceIdentifier": "-125241460",
"InvoiceType": "INVOICE",
"MultipleType": null,
"DocumentCreationDatetime": "2025-12-13T06:00:37.9428224+02:00",
"MessageId": "639012024379428224",
"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": 2147.76,
"DocumentTotalInclVAT": 1884.0,
"DocumentTotalVAT": 263.76,
"OrderNumber": 1189071577,
"PurchaseOrder": "1189071577",
"InvoiceDate": "2025-12-18T06:00:37.9428224+02:00",
"InvoiceNumber": "Invoice_Num",
"InvoiceDetails": [
{
"InvoiceDetailRefNo": "ad3093a4-2b96-4666-add8-1924f76a6605",
"InvoiceRefNo": "a0610cd9-1135-477e-a990-93843da5cf18",
"LineNumber": 1,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-12-13T00:00:00",
"CostPrice": 942.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 1073.88,
"TaxFeeType": "VAT",
"TaxAmount": 131.88
},
{
"InvoiceDetailRefNo": "5fef7b92-5c46-498e-8378-b9d8f46e738e",
"InvoiceRefNo": "a0610cd9-1135-477e-a990-93843da5cf18",
"LineNumber": 2,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-12-13T00:00:00",
"CostPrice": 942.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 1073.88,
"TaxFeeType": "VAT",
"TaxAmount": 131.88
}
]
}
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": "a0610cd9-1135-477e-a990-93843da5cf18",
"Standard": "EDI 3.2.0",
"TypeVersion": "3.2.0",
"InstanceIdentifier": "-125241460",
"InvoiceType": "INVOICE",
"MultipleType": null,
"DocumentCreationDatetime": "2025-12-13T06:00:37.9428224+02:00",
"MessageId": "639012024379428224",
"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": 2147.76,
"DocumentTotalInclVAT": 1884.0,
"DocumentTotalVAT": 263.76,
"OrderNumber": 1189071577,
"PurchaseOrder": "1189071577",
"InvoiceDate": "2025-12-18T06:00:37.9428224+02:00",
"InvoiceNumber": "Invoice_Num",
"InvoiceDetails": [
{
"InvoiceDetailRefNo": "ad3093a4-2b96-4666-add8-1924f76a6605",
"InvoiceRefNo": "a0610cd9-1135-477e-a990-93843da5cf18",
"LineNumber": 1,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-12-13T00:00:00",
"CostPrice": 942.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 1073.88,
"TaxFeeType": "VAT",
"TaxAmount": 131.88
},
{
"InvoiceDetailRefNo": "5fef7b92-5c46-498e-8378-b9d8f46e738e",
"InvoiceRefNo": "a0610cd9-1135-477e-a990-93843da5cf18",
"LineNumber": 2,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-12-13T00:00:00",
"CostPrice": 942.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 1073.88,
"TaxFeeType": "VAT",
"TaxAmount": 131.88
}
]
}