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": "fdd55fd4-1ec7-46b9-a908-c1be7bd51c72",
"Standard": "EDI 3.2.0",
"TypeVersion": "3.2.0",
"InstanceIdentifier": "-959173543",
"InvoiceType": "INVOICE",
"MultipleType": null,
"DocumentCreationDatetime": "2025-08-23T01:38:47.6987836+02:00",
"MessageId": "638915099276987836",
"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": 1591.44,
"DocumentTotalInclVAT": 1396.0,
"DocumentTotalVAT": 195.44,
"OrderNumber": 1180257217,
"PurchaseOrder": "1180257217",
"InvoiceDate": "2025-08-28T01:38:47.6987836+02:00",
"InvoiceNumber": "Invoice_Num",
"InvoiceDetails": [
{
"InvoiceDetailRefNo": "f7c0efb1-db35-4dd8-bccb-706d600c409f",
"InvoiceRefNo": "fdd55fd4-1ec7-46b9-a908-c1be7bd51c72",
"LineNumber": 1,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-08-23T00:00:00",
"CostPrice": 698.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 795.72,
"TaxFeeType": "VAT",
"TaxAmount": 97.72
},
{
"InvoiceDetailRefNo": "a4947583-2656-4bd2-b1a8-8a24cf9e1b86",
"InvoiceRefNo": "fdd55fd4-1ec7-46b9-a908-c1be7bd51c72",
"LineNumber": 2,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-08-23T00:00:00",
"CostPrice": 698.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 795.72,
"TaxFeeType": "VAT",
"TaxAmount": 97.72
}
]
}
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": "fdd55fd4-1ec7-46b9-a908-c1be7bd51c72",
"Standard": "EDI 3.2.0",
"TypeVersion": "3.2.0",
"InstanceIdentifier": "-959173543",
"InvoiceType": "INVOICE",
"MultipleType": null,
"DocumentCreationDatetime": "2025-08-23T01:38:47.6987836+02:00",
"MessageId": "638915099276987836",
"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": 1591.44,
"DocumentTotalInclVAT": 1396.0,
"DocumentTotalVAT": 195.44,
"OrderNumber": 1180257217,
"PurchaseOrder": "1180257217",
"InvoiceDate": "2025-08-28T01:38:47.6987836+02:00",
"InvoiceNumber": "Invoice_Num",
"InvoiceDetails": [
{
"InvoiceDetailRefNo": "f7c0efb1-db35-4dd8-bccb-706d600c409f",
"InvoiceRefNo": "fdd55fd4-1ec7-46b9-a908-c1be7bd51c72",
"LineNumber": 1,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-08-23T00:00:00",
"CostPrice": 698.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 795.72,
"TaxFeeType": "VAT",
"TaxAmount": 97.72
},
{
"InvoiceDetailRefNo": "a4947583-2656-4bd2-b1a8-8a24cf9e1b86",
"InvoiceRefNo": "fdd55fd4-1ec7-46b9-a908-c1be7bd51c72",
"LineNumber": 2,
"EANNumber": "EANNumber.........20",
"SupplierCode": 863222,
"Quantity": 50.0,
"PackSize": 12.0,
"TaxPercentage": 14.0,
"TaxFeeCategory": "STANDARD",
"UnitOfMeasure": "UnitOfMeasure.....20",
"TransferOfOwnershipDate": "2025-08-23T00:00:00",
"CostPrice": 698.0,
"LanguageISOCode": "LangISO.10",
"Description": "Description...........50",
"NettPrice": 795.72,
"TaxFeeType": "VAT",
"TaxAmount": 97.72
}
]
}