Procuros Incoming Transactions API
The Incoming Transactions API from Procuros — 3 operation(s) for incoming transactions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/procuros-incoming-transactions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Procuros All Transactions Incoming Transactions API
description: Manage Procuros Transactions.
version: 2.0.0
servers:
- url: https://api.procuros.io/
- url: https://api.procuros-staging.io/
security:
- api_token: []
tags:
- name: Incoming Transactions
paths:
/v2/transactions:
get:
operationId: v2_list_received_transactions
summary: List Incoming Transactions
description: List unprocessed incoming transactions from your trade partners.
tags:
- Incoming Transactions
parameters:
- name: filter[type]
in: query
required: false
allowReserved: true
schema:
$ref: '#/components/schemas/TransactionType'
- name: cursor
in: query
description: Page cursor
required: false
schema:
type: string
- name: per_page
in: query
description: Number of transactions returned per page.
required: false
schema:
type: integer
default: 100
minimum: 1
maximum: 100
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
required:
- items
- hasMore
- perPage
- count
- nextCursor
- nextPageUrl
properties:
items:
type: array
items:
$ref: '#/components/schemas/ReceivedTransaction'
hasMore:
type: boolean
description: Whether or not more transactions can be fetched on the next page.
perPage:
type: integer
description: Amount of transactions returned per page.
count:
type: integer
description: Amount of transactions on the current page.
nextCursor:
type:
- string
- 'null'
description: Supplied to the `cursor` query parameter. See [Pagination] for more info.
nextPageUrl:
type:
- string
- 'null'
format: url
description: Prebuilt URL to retrieve the next page of transactions.
examples:
List of transactions:
value:
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: jane.doe@example.com
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: jane.doe@example.com
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: jane.doe@example.com
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.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/GeneralValidationErrorResponse'
4XX:
description: Client Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalErrorResponse'
5XX:
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalErrorResponse'
/v2/transactions/{procurosTransactionId}:
parameters:
- name: procurosTransactionId
in: path
required: true
schema:
type: string
format: uuid
put:
operationId: v2_mark_transaction_processed
summary: Mark Transaction Processed
description: Report processing of incoming transactions.
tags:
- Incoming Transactions
requestBody:
description: Expected parameters to update a transaction.
required: true
content:
application/json:
schema:
type: object
required:
- success
properties:
success:
type: boolean
description: Whether or not your system was able to process the given transaction.
errorReason:
type: string
description: Reason your system was not able to process the given transaction.
errorType:
$ref: '#/components/schemas/ErrorType'
errorContext:
type: object
description: Additional context/meta data for the error.
additionalProperties:
type: string
examples:
Successfully Processed:
value:
success: true
Failed to Process:
value:
success: false
errorReason: Product GTIN '0001647296281' not found
errorType: DATA
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
required:
- data
properties:
data:
type: object
required:
- message
properties:
message:
type: string
description: Status message
errorUrl:
type: string
description: URL linking to the error on the Procuros Portal.
examples:
Successfully Processed:
value:
data:
message: OK.
Failed to Process:
value:
data:
message: OK.
errorUrl: https://portal.procuros.io/transactions/{{procurosTransactionId}}/errors
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/GeneralValidationErrorResponse'
4XX:
description: Client Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalErrorResponse'
5XX:
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalErrorResponse'
/v2/transactions/bulk/mark-processed:
post:
operationId: v2_bulk_mark_transactions_processed
summary: Bulk Mark Transactions Processed
description: Mark a list of incoming transactions as processed.
tags:
- Incoming Transactions
requestBody:
description: Expected parameters to mark transactions as processed.
required: true
content:
application/json:
schema:
type: object
required:
- items
properties:
items:
type: array
minItems: 1
maxItems: 1000
items:
type: object
required:
- procurosTransactionId
- success
properties:
procurosTransactionId:
$ref: '#/components/schemas/ProcurosTransactionId'
success:
type: boolean
description: Whether or not your system was able to process the given transaction.
errorReason:
type: string
description: Reason your system was not able to process the given transaction.
errorType:
$ref: '#/components/schemas/ErrorType'
errorContext:
type: object
description: Additional context/meta data for the error.
additionalProperties:
type: string
examples:
Example:
value:
- procurosTransactionId: 949b2ef2-3f40-465e-a7ee-ea3f9f189860
success: true
- procurosTransactionId: 949b2f25-fd9d-4c58-8899-b4dc277f8cf9
success: false
errorReason: Product GTIN '0001647296281' not found
errorType: DATA
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
required:
- data
properties:
data:
type: array
minItems: 1
items:
type: object
required:
- procurosTransactionId
- message
properties:
procurosTransactionId:
$ref: '#/components/schemas/ProcurosTransactionId'
message:
type: string
description: Status message
errorUrl:
type: string
examples:
Processed:
value:
data:
- procurosTransactionId: 949b2ef2-3f40-465e-a7ee-ea3f9f189860
message: OK.
- procurosTransactionId: 949b2f25-fd9d-4c58-8899-b4dc277f8cf9
message: OK.
errorUrl: https://portal.procuros.io/transactions/{{procurosTransactionId}}/errors
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/GeneralValidationErrorResponse'
4XX:
description: Client Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalErrorResponse'
5XX:
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalErrorResponse'
components:
schemas:
InventoryReport:
type: object
title: Inventory Report
required:
- header
- items
properties:
header:
$ref: '#/components/schemas/InventoryReportHeader'
items:
type: array
minItems: 1
items:
$ref: '#/components/schemas/InventoryReportItem'
ProductCatalogItem:
type: object
required:
- lineNumber
- quantity
- identity
properties:
name:
type: string
lineNumber:
type: integer
quantity:
type: number
format: float
identity:
$ref: '#/components/schemas/ProductCatalogIdentity'
predecessorIdentity:
$ref: '#/components/schemas/ProductCatalogIdentity'
successorIdentity:
$ref: '#/components/schemas/ProductCatalogIdentity'
alternativeIdentifiers:
type: array
items:
$ref: '#/components/schemas/ProductCatalogIdentity'
action:
type: string
enum:
- NEW
- CHANGED
- DELETED
currency:
$ref: '#/components/schemas/Currency'
unitOfMeasure:
$ref: '#/components/schemas/UnitOfMeasure'
isOrderable:
type: boolean
unitPrice:
type: number
format: float
pricingUnitOfMeasure:
type: string
maxLength: 255
description: The unit of measure used for pricing. This field specifies the unit that the price refers to, which may differ from the quantity unit (e.g., price per carton when quantity is in pieces).
pricingUnitQuantity:
type: number
format: float
description: 'The quantity of base units contained in the pricing unit of measure. For example, if the price is per carton (pricingUnitOfMeasure: "CT") and each carton contains 100 pieces, this field stores 100.'
unitPriceValidFromDate:
$ref: '#/components/schemas/DateTime'
unitPriceValidUntilDate:
$ref: '#/components/schemas/DateTime'
recommendedRetailPrice:
type: number
format: float
recommendedRetailPriceValidFromDate:
$ref: '#/components/schemas/DateTime'
recommendedRetailPriceValidUntilDate:
$ref: '#/components/schemas/DateTime'
minimumOrderQuantity:
type: number
format: float
taxPercentage:
type: number
format: float
depositAmount:
type: number
format: float
description: Deposit amount in the currency of the item.
shortDescription:
type: string
description:
type: string
perUnitQuantity:
type: number
format: float
description: Quantity of consumer units (pieces, bottles) contained in this item.
length:
type: integer
description: In millimeters
width:
type: integer
description: In millimeters
height:
type: integer
description: In millimeters
netWeight:
type: integer
description: In grams
grossWeight:
type: integer
description: In grams
drainedWeight:
type: integer
description: In grams
volume:
type: integer
description: In cubic centimeters
category:
type: string
description: Used for product category, commodity group
subCategory:
type: string
unNumber:
type: integer
description: 4-digit number assigned by the United Nations to classify hazardous substances and articles.
hsCode:
type: string
cnCode:
type: string
description: The 8-digit Combined Nomenclature (CN) code classifying this product for EU customs and trade statistics. Suppliers are responsible for providing a valid code.
htsCode:
type: string
deliverableFromDate:
$ref: '#/components/schemas/DateTime'
isDangerous:
type: boolean
hasExpiryDate:
type: boolean
hasBatchNumber:
type: boolean
hasSerialNumber:
type: boolean
minimumRemainingShelfLifeInDays:
type: integer
description: Minimum remaining shelf life in days.
sourceIdentifier:
type: string
description: Identifies the source (warehouse, supplier, etc.) from which the item can be procured.
originCountryCode:
type: string
description: ISO 3166-1 alpha-2 country code.
example: DE
colorCode:
type: string
description: Color code of the item.
colorName:
type: string
description: Color name of the item.
size:
type: string
description: Size of the item.
dimension:
type: string
description: Dimension of the item.
organicControlPointNumber:
type: string
maxLength: 255
description: 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.
fscNumber:
type: string
description: An FSC number refers to an identification number issued by the Forest Stewardship Council (FSC), an international organization that certifies sustainable forestry practices.
mscNumber:
type: string
description: An MSC number refers to an identification number issued by the Marine Stewardship Council (MSC), an international organization that certifies sustainable fishing practices.
season:
type: string
description: The season or collection period this item belongs to. Used to group and filter assortment by seasonal release.
gender:
type: string
description: The target gender this item is designed for (e.g. Male, Female, Unisex). Used to classify and filter assortment by gender segment.
example: SS27
brand:
type: string
description: BRAND in a PRICAT (Price Catalogue) refers to the name of the product’s brand or manufacturer. It helps identify the product’s origin and is essential for classification, marketing, and buyer recognition.
declarationOfConformity:
type: string
description: Declaration of Conformity in a PRICAT refers to a formal statement by the manufacturer confirming that the product meets all applicable EU safety, health, and environmental requirements. It is key for regulatory compliance and market approval.
userManual:
type: string
description: User Manual / Instructions in a PRICAT refers to the documentation provided with a product that explains its proper use, safety guidelines, and maintenance. It ensures safe handling and compliance with regulatory requirements.
energyLabel:
type: string
description: Energy Label in a PRICAT refers to the standardized label indicating a product’s energy efficiency class. It helps buyers assess energy consumption and supports compliance with EU energy labeling regulations.
safetyDatasheet:
type: string
description: Safety Datasheet in a PRICAT refers to a document providing detailed information on the safe handling, storage, and disposal of a product. It is essential for compliance with chemical safety regulations and workplace protection.
technicalDatasheet:
type: string
description: (Technical) Datasheet in a PRICAT refers to a document outlining the key technical specifications, features, and performance data of a product. It supports accurate product evaluation, comparison, and integration into systems or catalogues.
euDatasheet:
type: string
description: EU Datasheet in a PRICAT refers to a product information sheet tailored to meet EU regulatory and market requirements. It typically includes technical specifications, compliance details, and other essential data for distribution within the EU.
safetyInstructions:
type: string
description: Safety Instructions / Warnings in a PRICAT refer to mandatory information on potential hazards and safe usage of a product. They help ensure user safety and compliance with legal and regulatory standards.
materialComposition:
type: string
description: All material components
ingredients:
type: string
description: A simple string field to transmit the list of ingredients of a food item
allergens:
type: array
description: An array of allergens that are contained in a food item
items:
type: object
properties:
identifiers:
type: object
description: Identifiers for the allergen
properties:
gdsn:
type: string
description: GDSN identifier of the allergen
usda:
type: string
description: USDA identifier of the allergen
bls:
type: string
description: BLS identifier of the allergen
senderInternal:
type: string
description: Sender internal identifier of the allergen
receiverInternal:
type: string
description: Receiver internal identifier of the allergen
name:
type: string
description: Name of the allergen
presence:
type: string
description: Presence of the allergen in the product
enum:
- PRESENT
- TRACES
- FREE_FROM
- UNKNOWN
nutritionalInformation:
type: object
description: Comprehensive nutritional information for the product
properties:
energy:
type: object
properties:
totalInKcal:
type: number
format: float
description: Total energy in kilocalories
totalInKj:
type: number
format: float
description: Total energy in kilojoules
fats:
type: object
properties:
totalInGrams:
type: number
format: float
saturatedInGrams:
type: number
format: float
monounsaturatedInGrams:
type: number
format: float
polyunsaturatedInGrams:
type: number
# --- truncated at 32 KB (169 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/procuros/refs/heads/main/openapi/procuros-incoming-transactions-api-openapi.yml