Show Transaction

GET

all-transactions

{procurosTransactionId}

curl --request GET \
  --url https://api.procuros.io/v2/all-transactions/{procurosTransactionId} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "procurosTransactionId": "949b2f25-fd9d-4c58-8899-b4dc277f8cf9",
    "type": "ORDER",
    "flow": "LIVE",
    "status": "SUCCESS",
    "createdAt": "2024-01-01T00:00:00+00:00",
    "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
        }
      ]
    }
  }
}

Authorizations

Authorization

string

header

required

The API Token of your ERP Connection.

Path Parameters

procurosTransactionId

string

required

Response

200

application/json

Success

data

object

required

data.procurosTransactionId

string

required

Unique ID assigned to every transaction on the Procuros Network.

Example:

"949b2f25-fd9d-4c58-8899-b4dc277f8cf9"

data.type

enum<string>

required

Type of transaction.

Available options:

ORDER,

ORDER_RESPONSE,

SHIPPING_NOTICE,

INVOICE,

CREDIT_NOTE,

DISPATCH_INSTRUCTION,

DISPATCH_INSTRUCTION_RESPONSE,

RECEIVAL_NOTICE,

REMITTANCE_ADVICE,

PRODUCT_CATALOG

data.status

enum<string>

required

Current status of the transaction.

Available options:

PENDING,

SUCCESS,

FAILED,

DROPPED,

UNKNOWN

data.flow

enum<string>

required

Flow (LIVE or TEST) of the transaction.

Available options:

LIVE,

TEST

data.createdAt

string

required

Example:

"2021-10-23T00:00:00.000000Z"

data.content

object

required

A purchase order is a formal request from a buying organization to a supplier to fulfill a contract.

data.content.header

object

required

data.content.header.buyer

object

required

data.content.header.supplier

object

required

data.content.header.orderIdentifier

string

required

Order number assigned to this purchase order by the buyer.

Example:

"PO9383-R45"

data.content.header.orderDate

string

required

Example:

"2021-10-23T00:00:00.000000Z"

data.content.header.shipTo

object

If this is kept empty, the "buyer" is used as the "shipTo" party.

data.content.header.billTo

object

If this is kept empty, the "buyer" is used as the "billTo" party.

data.content.header.finalRecipient

object

Used in case the shipTo is not the final recipient. Mostly used in dropshipping or cross-docking scenarios.

data.content.header.type

string

Type of the order as assigned by sender.

data.content.header.requestedDeliveryDate

string

Example:

"2021-10-23T00:00:00.000000Z"

data.content.header.currency

string

ISO 4217 standard three-letter currency code.

Example:

"EUR"

data.content.header.comments

string

Arbitrary human-readable information buyers can send within purchase orders

Maximum length: 100000

data.content.header.deliveryInformation

string

Delivery information for the order.

Maximum length: 100000

data.content.header.promotionCode

string

Promotion code applied to the entire order.

Maximum length: 255

data.content.header.contractReference

string

Contract reference for the order.

Maximum length: 255

data.content.header.version

integer

The document version number. Subsequent updates should increment this number by 1.

data.content.header.attachments

object[]

data.content.header.customProperties

object

data.content.items

object[]

required

data.content.items.lineNumber

integer

LineNumber attribute may remain constant for any item through updates to the order, therefor lineNumbers may not be consecutive.

Example:

1

data.content.items.identifiers

object[]

There must be at least one identifier with domain GS1 or BUYER.

data.content.items.isDepositItem

boolean

If true, the item is a deposit item such as bottle deposit (German: Pfandartikel).

data.content.items.quantity

number

Defaults to 1.

Example:

2

data.content.items.unitOfMeasure

enum<string>

default:EA

Subset of the the UN/CEFACT Unit of Measure Common Codes.

Available options:

EA,

GRM,

HUR,

KGM,

LTR,

MLT,

MTK,

MTR,

PCK,

SET,

CS,

CA,

DAY,

WEE,

MON,

CT,

CQ,

CU,

BJ,

BO,

MTQ,

PF,

BG,

RO,

TNE,

BE,

CMT,

KMT,

PR,

TU

data.content.items.description

string

data.content.items.comments

string

data.content.items.unitPrice

number

Example:

4.75

data.content.items.recommendedRetailPrice

number

Example:

5.25

data.content.items.tax

object

data.content.items.promotionCode

string

Promotion code applied to this item.

Maximum length: 255

data.content.items.contractReference

string

Contract reference for this item.

Maximum length: 255

data.content.items.requestedDeliveryDate

string

Example:

"2021-10-23T00:00:00.000000Z"

data.content.items.requestedEarliestDeliveryDate

string

Example:

"2021-10-23T00:00:00.000000Z"

data.content.items.requestedLatestDeliveryDate

string

Example:

"2021-10-23T00:00:00.000000Z"

data.content.items.deliveryGracePeriodInDays

integer

Delivery grace period in days.

data.content.items.minimumRemainingShelfLifeInDays

integer

Minimum remaining shelf life in days.

data.content.items.netWeight

number

Net weight of the item in grams.

data.content.items.grossWeight

number

Gross weight of the item in grams.

data.content.items.originCountryCode

string

ISO 3166-1 alpha-2 country code.

data.content.items.colorCode

string

Color code of the item.

data.content.items.colorName

string

Color name of the item.

data.content.items.size

string

Size of the item.

data.content.items.dimension

string

Dimension of the item.

data.content.items.hsCode

string

Harmonized System Code of the item.

data.content.items.organicControlPointNumber

string

Organic Control Point Number of the supplier - OCPN is a unique identifier that verifies that a producer of organic products is adhering to the standards for organic production.

Maximum length: 255

data.content.items.fscNumber

string

An FSC number refers to an identification number issued by the Forest Stewardship Council (FSC), an international organization that certifies sustainable forestry practices.

data.content.items.customProperties

object

Was this page helpful?

List All Transactions List Incoming Tasks

curl --request GET \
  --url https://api.procuros.io/v2/all-transactions/{procurosTransactionId} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "procurosTransactionId": "949b2f25-fd9d-4c58-8899-b4dc277f8cf9",
    "type": "ORDER",
    "flow": "LIVE",
    "status": "SUCCESS",
    "createdAt": "2024-01-01T00:00:00+00:00",
    "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
        }
      ]
    }
  }
}

Getting Started

Documents

Guides

Endpoints

Authorizations

Path Parameters

Response