Get Carrier Biller Fiscal Invoice Corrections

GET REST API endpoint for retrieving fiscalized refund invoices for delivery services, intended for carrier-biller-integration. Invoice corrections are linked to the CarrierBiller entity via the Shipment <-> Carrier <-> CarrierBiller relationship.

Authentication is performed using a Bearer Token (JWT) obtained via the ClientCredentials flow with scope carrierbiller_public_api/full_access. All timestamps are in UTC.

Since responses from the eFiscalization vendor (Cornerstone) may have a chronological delay relative to the actual fiscalization date in the Tax Authority, this endpoint filters by the Cornerstone response received timestamp, not the Tax Authority fiscalization date.

Request

HTTP Method

GET

URL

Stage

https://api.qa2.ananastest.com/order/api/v2/carrier-biller-integration/invoice-corrections/fiscal

Production

https://api.ananas.rs/order/api/v2/carrier-biller-integration/invoice-corrections/fiscal

HTTP Headers

Header name	Header value
Authorization	Bearer {access_token}

Query Parameters

Parameter name	Type	Required	Description
receivedEfiscalDateFrom	ISO.DATE_TIME	True	eFiscal data received date_time from
receivedEfiscalDateTo	ISO.DATE_TIME	True	eFiscal data received date_time to

Example Request

GET https://api.qa2.ananastest.com/order/api/v2/carrier-biller-integration/invoice-corrections/fiscal?receivedEfiscalDateFrom=2026-03-01T00:00:00.0000000Z&receivedEfiscalDateTo=2026-03-01T23:59:59.0000000Z Authorization: Bearer ACCESS_TOKEN

Response

Returns a list of fiscalized refund invoices for delivery services associated with the resolved CarrierBiller.

Fields

Field name	Type	Description
shipmentDetails.orderId	String	Order ID
shipmentDetails.suborderId	String	Suborder ID
shipmentDetails.suborderType	String	Suborder type
shipmentDetails.createdDate	ISO DateTime	Suborder created date
shipmentDetails.carrierCode	String	Carrier code
shipmentDetails.carrierName	String	Carrier name
financialDetails.invoiceType	String	Always `REFUND` for this endpoint
financialDetails.items	Array	Invoice line items (code, name, quantity, vat, basePrice, basePriceWithoutVat)
financialDetails.payment	Array	Payment details (amount, paymentType)
financialDetails.isLegalEntityBuyer	Boolean	Whether the buyer is a legal entity
financialDetails.legalEntityBuyer	Object	Legal entity buyer info (buyerTin, buyerName). Present only when isLegalEntityBuyer is `true`
fiscalInvoiceDetails.fiscalInvoiceNumber	String	Fiscal invoice number of this correction
fiscalInvoiceDetails.fiscalInvoiceDate	ISO DateTime	Fiscal invoice date of this correction
fiscalInvoiceDetails.invoiceCounter	String	Invoice counter
fiscalInvoiceDetails.verificationUrl	String	Tax Authority verification URL
fiscalInvoiceDetails.journal	String	Fiscal receipt journal text
fiscalInvoiceDetails.referentFiscalInvoiceNumber	String	Fiscal invoice number of the original sale invoice being corrected
fiscalInvoiceDetails.active	Boolean	Whether the invoice correction is active

Example Response

[
  {
    "shipmentDetails": {
      "orderId": "OQI39-EURSE",
      "suborderId": "OQI39-EURSE-DS-1",
      "suborderType": "DS",
      "createdDate": "2026-03-22T21:10:17.592064Z",
      "carrierCode": "CEX01",
      "carrierName": "City Express"
    },
    "financialDetails": {
      "invoiceType": "REFUND",
      "items": [
        {
          "code": "SHIPPING_COST",
          "name": "DOSTAVA (pripadajuća)",
          "quantity": 1,
          "vat": 20,
          "basePrice": 349.00,
          "basePriceWithoutVat": 290.83
        },
        {
          "code": "CASH_HANDLING_FEE",
          "name": "Naknada za plaćanje pouzećem",
          "quantity": 1,
          "vat": 20,
          "basePrice": 200.00,
          "basePriceWithoutVat": 166.67
        }
      ],
      "payment": [
        {
          "amount": 549,
          "paymentType": "COD"
        }
      ],
      "isLegalEntityBuyer": false
    },
    "fiscalInvoiceDetails": {
      "fiscalInvoiceNumber": "7LP837JA-372A5WO0-961",
      "fiscalInvoiceDate": "2026-03-25T01:25:51Z",
      "invoiceCounter": "851/960",
      "verificationUrl": "https://suf.purs.gov.rs/v/....",
      "journal": "============ ФИСКАЛНИ РАЧУН ============....",
      "referentFiscalInvoiceNumber": "7LP837JA-372A5WO0-960",
      "active": false
    }
  }
]