Incoming Transactions
List Incoming Transactions
Getting Started
- Overview
- Quick Start
- API Concepts
Endpoints
- Incoming Transactions
- Outgoing Transactions
- All Transactions
- Tasks
- Misc
Incoming Transactions
List Incoming Transactions
List unprocessed incoming transactions from your trade partners.
GET
/
v2
/
transactions
curl --request GET \
--url https://api.procuros.io/v2/transactions \
--header 'Authorization: Bearer <token>'{
"hasMore": false,
"perPage": 100,
"count": 3,
"nextCursor": null,
"nextPageUrl": null,
"items": [
{
"procurosTransactionId": "949b2f25-fd9d-4c58-8899-b4dc277f8cf9",
"type": "ORDER",
"content": {
"header": {
"buyer": {
"name": "ACME Co. Ltd.",
"identifiers": [
{
"identifier": "1100001016310",
"domain": "GS1"
}
],
"postalAddress": {
"name": "ACME Co. Ltd.",
"street": "Elroy-Fritsch-Ring 15",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "82643"
},
"contacts": [
{
"firstName": "John",
"lastName": "Doe",
"email": "[email protected]",
"fax": "(818) 463-6124",
"phone": "+1.352.856.0626"
}
]
},
"supplier": {
"name": "Testsupplier",
"identifiers": [
{
"identifier": "1100001016312",
"domain": "GS1"
}
]
},
"shipTo": {
"identifiers": [
{
"identifier": "1100001016313",
"domain": "GS1"
}
]
},
"billTo": {
"identifiers": [
{
"identifier": "1100001016314",
"domain": "GS1"
}
]
},
"orderIdentifier": "PO9383-R45",
"orderDate": "2021-09-30",
"currency": "EUR",
"requestedDeliveryDate": "2021-10-05",
"comments": "Something to comment"
},
"items": [
{
"lineNumber": 1,
"identifiers": [
{
"identifier": "4300348765432",
"domain": "GS1"
},
{
"identifier": "PROD-77-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_8",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"quantity": 20,
"unitOfMeasure": "EA",
"description": "First product description.",
"unitPrice": 0.15
},
{
"lineNumber": 2,
"identifiers": [
{
"identifier": "4300348765433",
"domain": "GS1"
},
{
"identifier": "PROD-78-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_9",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"quantity": 19,
"unitOfMeasure": "EA",
"description": "Sparkling Water - Crate (6x0.75l).",
"unitPrice": 1.5
},
{
"lineNumber": 3,
"identifiers": [
{
"identifier": "4300348765434",
"domain": "GS1"
},
{
"identifier": "PFAND-00B-LS",
"domain": "SUPPLIER"
}
],
"isDepositItem": true,
"quantity": 19,
"unitOfMeasure": "EA",
"description": "Deposit 1x crate + 6x bottles.",
"unitPrice": 3.3
}
]
}
},
{
"procurosTransactionId": "94fe13aa-8c9b-40e5-9937-42b852185858",
"type": "SHIPPING_NOTICE",
"content": {
"header": {
"buyer": {
"name": "ACME Co. Ltd.",
"identifiers": [
{
"identifier": "1100001016310",
"domain": "GS1"
}
],
"postalAddress": {
"city": "Berlin",
"countryCode": "DE",
"name": "ACME Co. Ltd.",
"postalCode": "82643",
"street": "Elroy-Fritsch-Ring 15"
},
"contacts": [
{
"firstName": "Jane",
"lastName": "Doe",
"email": "[email protected]",
"fax": "(818) 463-6124",
"phone": "+1.352.856.0626"
}
]
},
"supplier": {
"name": "Testsupplier",
"identifiers": [
{
"identifier": "1100001016312",
"domain": "GS1"
}
]
},
"shipTo": {
"identifiers": [
{
"identifier": "1100001016313",
"domain": "GS1"
}
]
},
"billTo": {
"identifiers": [
{
"identifier": "1100001016314",
"domain": "GS1"
}
]
},
"shippingNoticeIdentifier": "SN9383-R45",
"shippingNoticeDate": "2021-11-24",
"orderIdentifier": "PO9383-R45",
"orderDate": "2021-11-20",
"despatchDate": "2021-11-05",
"requestedDeliveryDate": "2021-11-06",
"expectedDeliveryDate": "2021-11-06",
"carrier": "Example Delivery Solution",
"trackingNumber": "b52ea6a7-c2ea-3bfc-a63f-19140d3b3af5",
"trackingUrl": "https://api.procuros.com/example",
"comments": "Something to comment"
},
"transportUnits": [
{
"items": [
{
"lineNumber": 1,
"orderLineNumber": 1,
"identifiers": [
{
"identifier": "4300348765432",
"domain": "GS1"
},
{
"identifier": "PROD-77-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_8",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"orderedQuantity": 20,
"shippedQuantity": 20,
"unitPrice": 200,
"description": "First product description."
},
{
"lineNumber": 2,
"orderLineNumber": 2,
"identifiers": [
{
"identifier": "4300348765433",
"domain": "GS1"
},
{
"identifier": "PROD-78-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_9",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"orderedQuantity": 19,
"shippedQuantity": 15,
"openQuantityAction": "DISCARDED",
"unitPrice": 1.5,
"description": "Second product description."
}
]
}
]
}
},
{
"procurosTransactionId": "94fe1224-ae01-4587-8155-8e852cbbe75d",
"type": "INVOICE",
"content": {
"header": {
"buyer": {
"name": "ACME Co. Ltd.",
"identifiers": [
{
"identifier": "4522704465331",
"domain": "GS1"
},
{
"identifier": "DE123456789",
"domain": "VAT_DE"
}
],
"postalAddress": {
"city": "Berlin",
"countryCode": "DE",
"name": "ACME Co. Ltd.",
"postalCode": "82643",
"street": "Elroy-Fritsch-Ring 15"
},
"contacts": [
{
"firstName": "Jane",
"lastName": "Doe",
"email": "[email protected]",
"fax": "(818) 463-6124",
"phone": "+1.352.856.0626"
}
]
},
"supplier": {
"name": "Testsupplier",
"identifiers": [
{
"identifier": "4231930775745",
"domain": "GS1"
},
{
"identifier": "DE234567890",
"domain": "VAT_DE"
}
]
},
"shipTo": {
"identifiers": [
{
"identifier": "1100001016313",
"domain": "GS1"
}
]
},
"billTo": {
"identifiers": [
{
"identifier": "1100001016314",
"domain": "GS1"
}
]
},
"invoiceIdentifier": "IV9383-R45",
"invoiceDate": "2021-11-11",
"shippingNoticeIdentifier": "SN9383-R45",
"shippingNoticeDate": "2021-11-04",
"orderIdentifier": "PO9383-R45",
"orderDate": "2021-11-10",
"paymentTerms": [
{
"payInNumberOfDays": 28,
"percentage": 3
}
],
"comments": "Something to comment"
},
"items": [
{
"lineNumber": 1,
"identifiers": [
{
"identifier": "4300348765432",
"domain": "GS1"
},
{
"identifier": "PROD-77-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_8",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"quantity": 20,
"unitPrice": 200,
"description": "First product description.",
"tax": {
"amount": 760,
"percentage": 19,
"description": "Total tax amount."
}
},
{
"lineNumber": 2,
"identifiers": [
{
"identifier": "4300348765433",
"domain": "GS1"
},
{
"identifier": "PROD-78-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_9",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"quantity": 15,
"unitPrice": 1.5,
"description": "Second product description.",
"tax": {
"amount": 26.775,
"percentage": 19,
"description": "Total tax amount."
}
}
]
}
}
]
}Authorizations
The API Token of your ERP Connection.
Query Parameters
Type of transaction.
Available options:
ORDER, ORDER_RESPONSE, SHIPPING_NOTICE, INVOICE, CREDIT_NOTE, DISPATCH_INSTRUCTION, DISPATCH_INSTRUCTION_RESPONSE, RECEIVAL_NOTICE, REMITTANCE_ADVICE, PRODUCT_CATALOG Page cursor
Number of transactions returned per page.
Required range:
1 <= x <= 100Response
200
application/json
Success
The response is of type object.
Was this page helpful?
curl --request GET \
--url https://api.procuros.io/v2/transactions \
--header 'Authorization: Bearer <token>'{
"hasMore": false,
"perPage": 100,
"count": 3,
"nextCursor": null,
"nextPageUrl": null,
"items": [
{
"procurosTransactionId": "949b2f25-fd9d-4c58-8899-b4dc277f8cf9",
"type": "ORDER",
"content": {
"header": {
"buyer": {
"name": "ACME Co. Ltd.",
"identifiers": [
{
"identifier": "1100001016310",
"domain": "GS1"
}
],
"postalAddress": {
"name": "ACME Co. Ltd.",
"street": "Elroy-Fritsch-Ring 15",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "82643"
},
"contacts": [
{
"firstName": "John",
"lastName": "Doe",
"email": "[email protected]",
"fax": "(818) 463-6124",
"phone": "+1.352.856.0626"
}
]
},
"supplier": {
"name": "Testsupplier",
"identifiers": [
{
"identifier": "1100001016312",
"domain": "GS1"
}
]
},
"shipTo": {
"identifiers": [
{
"identifier": "1100001016313",
"domain": "GS1"
}
]
},
"billTo": {
"identifiers": [
{
"identifier": "1100001016314",
"domain": "GS1"
}
]
},
"orderIdentifier": "PO9383-R45",
"orderDate": "2021-09-30",
"currency": "EUR",
"requestedDeliveryDate": "2021-10-05",
"comments": "Something to comment"
},
"items": [
{
"lineNumber": 1,
"identifiers": [
{
"identifier": "4300348765432",
"domain": "GS1"
},
{
"identifier": "PROD-77-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_8",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"quantity": 20,
"unitOfMeasure": "EA",
"description": "First product description.",
"unitPrice": 0.15
},
{
"lineNumber": 2,
"identifiers": [
{
"identifier": "4300348765433",
"domain": "GS1"
},
{
"identifier": "PROD-78-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_9",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"quantity": 19,
"unitOfMeasure": "EA",
"description": "Sparkling Water - Crate (6x0.75l).",
"unitPrice": 1.5
},
{
"lineNumber": 3,
"identifiers": [
{
"identifier": "4300348765434",
"domain": "GS1"
},
{
"identifier": "PFAND-00B-LS",
"domain": "SUPPLIER"
}
],
"isDepositItem": true,
"quantity": 19,
"unitOfMeasure": "EA",
"description": "Deposit 1x crate + 6x bottles.",
"unitPrice": 3.3
}
]
}
},
{
"procurosTransactionId": "94fe13aa-8c9b-40e5-9937-42b852185858",
"type": "SHIPPING_NOTICE",
"content": {
"header": {
"buyer": {
"name": "ACME Co. Ltd.",
"identifiers": [
{
"identifier": "1100001016310",
"domain": "GS1"
}
],
"postalAddress": {
"city": "Berlin",
"countryCode": "DE",
"name": "ACME Co. Ltd.",
"postalCode": "82643",
"street": "Elroy-Fritsch-Ring 15"
},
"contacts": [
{
"firstName": "Jane",
"lastName": "Doe",
"email": "[email protected]",
"fax": "(818) 463-6124",
"phone": "+1.352.856.0626"
}
]
},
"supplier": {
"name": "Testsupplier",
"identifiers": [
{
"identifier": "1100001016312",
"domain": "GS1"
}
]
},
"shipTo": {
"identifiers": [
{
"identifier": "1100001016313",
"domain": "GS1"
}
]
},
"billTo": {
"identifiers": [
{
"identifier": "1100001016314",
"domain": "GS1"
}
]
},
"shippingNoticeIdentifier": "SN9383-R45",
"shippingNoticeDate": "2021-11-24",
"orderIdentifier": "PO9383-R45",
"orderDate": "2021-11-20",
"despatchDate": "2021-11-05",
"requestedDeliveryDate": "2021-11-06",
"expectedDeliveryDate": "2021-11-06",
"carrier": "Example Delivery Solution",
"trackingNumber": "b52ea6a7-c2ea-3bfc-a63f-19140d3b3af5",
"trackingUrl": "https://api.procuros.com/example",
"comments": "Something to comment"
},
"transportUnits": [
{
"items": [
{
"lineNumber": 1,
"orderLineNumber": 1,
"identifiers": [
{
"identifier": "4300348765432",
"domain": "GS1"
},
{
"identifier": "PROD-77-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_8",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"orderedQuantity": 20,
"shippedQuantity": 20,
"unitPrice": 200,
"description": "First product description."
},
{
"lineNumber": 2,
"orderLineNumber": 2,
"identifiers": [
{
"identifier": "4300348765433",
"domain": "GS1"
},
{
"identifier": "PROD-78-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_9",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"orderedQuantity": 19,
"shippedQuantity": 15,
"openQuantityAction": "DISCARDED",
"unitPrice": 1.5,
"description": "Second product description."
}
]
}
]
}
},
{
"procurosTransactionId": "94fe1224-ae01-4587-8155-8e852cbbe75d",
"type": "INVOICE",
"content": {
"header": {
"buyer": {
"name": "ACME Co. Ltd.",
"identifiers": [
{
"identifier": "4522704465331",
"domain": "GS1"
},
{
"identifier": "DE123456789",
"domain": "VAT_DE"
}
],
"postalAddress": {
"city": "Berlin",
"countryCode": "DE",
"name": "ACME Co. Ltd.",
"postalCode": "82643",
"street": "Elroy-Fritsch-Ring 15"
},
"contacts": [
{
"firstName": "Jane",
"lastName": "Doe",
"email": "[email protected]",
"fax": "(818) 463-6124",
"phone": "+1.352.856.0626"
}
]
},
"supplier": {
"name": "Testsupplier",
"identifiers": [
{
"identifier": "4231930775745",
"domain": "GS1"
},
{
"identifier": "DE234567890",
"domain": "VAT_DE"
}
]
},
"shipTo": {
"identifiers": [
{
"identifier": "1100001016313",
"domain": "GS1"
}
]
},
"billTo": {
"identifiers": [
{
"identifier": "1100001016314",
"domain": "GS1"
}
]
},
"invoiceIdentifier": "IV9383-R45",
"invoiceDate": "2021-11-11",
"shippingNoticeIdentifier": "SN9383-R45",
"shippingNoticeDate": "2021-11-04",
"orderIdentifier": "PO9383-R45",
"orderDate": "2021-11-10",
"paymentTerms": [
{
"payInNumberOfDays": 28,
"percentage": 3
}
],
"comments": "Something to comment"
},
"items": [
{
"lineNumber": 1,
"identifiers": [
{
"identifier": "4300348765432",
"domain": "GS1"
},
{
"identifier": "PROD-77-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_8",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"quantity": 20,
"unitPrice": 200,
"description": "First product description.",
"tax": {
"amount": 760,
"percentage": 19,
"description": "Total tax amount."
}
},
{
"lineNumber": 2,
"identifiers": [
{
"identifier": "4300348765433",
"domain": "GS1"
},
{
"identifier": "PROD-78-LS",
"domain": "BUYER"
},
{
"identifier": "sp_gr_9",
"domain": "SUPPLIER"
}
],
"isDepositItem": false,
"quantity": 15,
"unitPrice": 1.5,
"description": "Second product description.",
"tax": {
"amount": 26.775,
"percentage": 19,
"description": "Total tax amount."
}
}
]
}
}
]
}