Skip to main content
Trade partners sometimes send updated versions of a document they already sent — for example, a revised order with a changed quantity or an amended invoice. Procuros detects these and links the old and new versions together automatically. Every transaction returned by the API includes three fields that tell you where it sits in that version chain:
FieldTypeDescription
isLatestVersionbooleantrue if no newer version exists. false if this document has been superseded.
replacesProcurosTransactionIduuid | nullThe ID of the older transaction this one replaces. null if this is the original document.
replacedByProcurosTransactionIduuid | nullThe ID of the newer transaction that replaced this one. null if this is still the current version.
Always check isLatestVersion before importing a document into your system. If the value is false, a newer version of the document is already available and the one you are looking at should be skipped or voided.
php
foreach ($body->items as $transaction) {
    if (!$transaction->isLatestVersion) {
        // A newer version exists — skip or void this document
        continue;
    }

    // Safe to import
    importTransaction($transaction);
}
If isLatestVersion is false and the document was already imported, you can use replacedByProcurosTransactionId to identify the newer version. The newer version will also appear as a separate pending transaction on GET /v2/transactions, so no additional API call is needed — simply skip the outdated document and process the newer one when it comes up.
php
if (!$transaction->isLatestVersion) {
    // A newer version will arrive (or has already arrived) as its own pending transaction.
    // Skip this outdated document, or void it if it was already imported.
    continue;
}

​
Marking outdated versions as processed

When you mark a transaction as processed, Procuros records that you have acknowledged it. If a transaction in your queue turns out to have isLatestVersion: false, you do not need to take any special action — Procuros automatically removes outdated versions from the pending queue before they are returned to you. You will only ever need to mark the latest version as processed.

​
Version Chain Example

Given three versions of the same order:
procurosTransactionIdreplacesProcurosTransactionIdreplacedByProcurosTransactionIdisLatestVersion
aaa-111nullbbb-222false
bbb-222aaa-111ccc-333false
ccc-333bbb-222nulltrue
Only ccc-333 should be imported. The earlier versions can be safely skipped or voided.
When polling via GET /v2/transactions (pending transactions), outdated versions are removed from the queue automatically as soon as a newer version is detected. isLatestVersion will always be true for transactions returned by this endpoint.