[POST] .../v1/invoiceoperation/getoperationsfromroaming
Gets operations account-invoice with roaming (service EDI). Use this method to retrieve item rows of an invoice document from the configured EDI provider before importing or comparing them with local invoice operations. The request supports filters for provider-side operation selectors and the response returns provider-side InvoiceRoamingOperation rows, including item name, ICPS, barcode, package data, quantity, price, labels, origin and VAT rate. firm_id must identify a company with EDI integration settings, document_id must be the EDI-side invoice identifier and the current request user must have invoice operation select permission. Missing body, invalid firm_id or document_id, denied permission, missing EDI settings, provider failures and adapter errors are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| filters | Array of Filter | Optional | Optional filters by fields available for this API method. |
Filterable Fields
| Field | Type | Description |
|---|---|---|
| document_id | string | Invoice ID in the EDI system. |
| firm_id | int | Company ID. |
Request Example
{
"filters": [
{
"Field": "firm_id",
"Operator": "Equal",
"Value": "301"
},
{
"Field": "document_id",
"Operator": "Equal",
"Value": "roaming-invoice-2026-00045"
}
]
}Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Array of InvoiceRoamingOperation | Result object. |
Response Example
{
"ok": true,
"result": [
{
"name": "Arabica Coffee 1 kg",
"icps": "01234567890123",
"barcode": "4780012345678",
"package_code": "796",
"package_name": "piece",
"quantity": 3,
"price": 50000,
"labels": [],
"group_labels": [],
"transport_labels": [],
"origin": 0,
"vat_rate": 12
}
]
}