SbPublicApiGetOrderResponse

snowbee.SbPublicApiGetOrderResponse

capturesrequired
Show item fields
amountoptional

Captured amount

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"
createdDateoptional

Date the capture was created

  • Format: date
Example"2024-06-15"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
linesrequired
Show item fields
lineItemIdrequired

Reference to order line item

Example"01234567-89ab-cdef-0123-456789abcdef"
quantityrequired

Quantity captured

  • Format: BigDecimal
Example"2.0"
statusrequired

Capture status

Allowed values"PENDING""CONFIRMED""FAILED"
currencyIsoCoderequired

ISO 4217 currency code

Example"NOK"
customerIdrequired

Customer ID associated with the order

Example"01234567-89ab-cdef-0123-456789abcdef"
deliveryAddressrequired
Show child fields
cityrequired
Example"Oslo"
countryIsoCoderequired

ISO 3166-1 alpha-2 country code

Example"NO"
emailoptional
Example"ola.nordmann@example.com"
namerequired

Recipient name

Example"Ola Nordmann"
phoneoptional
Example"+4790123456"
postCoderequired
Example"0123"
streetrequired

Street address including house number

Example"Storgata 1"
externalOrderIdoptional

External order ID from your e-commerce platform

Example"SHOP-123"
externalOrderNumberoptional

External order number displayed to customer

Example"WEB-2024-00123"
freightoptional
Show child fields
carrierAgreementCoderequired
Example"6838716034162098000"
carrierCoderequired
Example"porterbuddy"
carrierNameoptional
Example"Porterbuddy"
carrierProductCoderequired
Example"8747679326213767168"
carrierProductNameoptional
Example"Evening delivery"
carrierProductPayloadoptional

Provider-specific extra data

Show child fields
partnerNameoptional

Partner name from provider

partnerNumberoptional

Partner number from provider

freightVatRateoptional

VAT rate for freight as a percentage

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"25.00"
netFreightAmountoptional

Net freight/shipping cost amount (excl. VAT)

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"49.00"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
invoiceAddressrequired
Show child fields
cityrequired
Example"Oslo"
countryIsoCoderequired

ISO 3166-1 alpha-2 country code

Example"NO"
emailrequired

Email for invoice delivery

Example"ola.nordmann@example.com"
namerequired

Recipient name

Example"Ola Nordmann"
postCoderequired
Example"0123"
streetrequired

Street address including house number

Example"Storgata 1"
lineItemsrequired
Show item fields
barcodeoptional

Barcode (EAN/GTIN)

Example"1234567890123"
cancelledQuantityoptional

Quantity cancelled after line closure; null while the line is open or fully shipped

  • Format: BigDecimal
Example"1.0"
discountrequired

Discount percentage applied to this line

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"0.00"
estimatedDeliveryDaterequired
  • Format: date
Example"2024-06-20"
fulfilledQuantityrequired

Quantity fulfilled/shipped for this line

  • Format: BigDecimal
Example"2.0"
grossAmountrequired

Gross amount including VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
netAmountrequired

Net amount excluding VAT (quantity × netUnitPrice)

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"598.00"
netUnitOrderDiscountAmountrequired

Net unit order discount amount applied to this line

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"10.00"
netUnitPricerequired

Net unit price excluding VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"299.00"
productNamerequired
Example"Classic T-Shirt Black Medium"
quantityrequired

Quantity ordered

  • Format: BigDecimal
Example"2.0"
returnTicketBarcodeUrloptional

URL to a Code128 barcode SVG image for this line's exchange label. The last path segment is the base64url encoding of the scannable barcode value "SO <order number> <line position>", which is what the barcode encodes, not the return ticket number above

Example"/v1/tenants/{tenantId}/ecom_stores/{eComStoreId}/barcodes/code128/U08gV0VCNDAwOTkwMyAy"
returnTicketNumberrequired

Human readable return ticket number (exchange label code) for this line, the order number followed by the line position

Example"WEB40099032"
skuIdrequired

SKU ID of the product

Example"01234567-89ab-cdef-0123-456789abcdef"
skuNumberrequired
Example"PROD-BLK-M"
vatAmountrequired

VAT amount

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"149.50"
vatRaterequired

VAT rate as percentage

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"25.00"
orderDaterequired

Date the order was placed

  • Format: date
Example"2024-06-15"
orderNumberrequired

Human-readable order number

Example"SO-2024-00123"
orderStatusrequired

Current status of the order

Allowed values"PLANNED""CLOSED""RELEASED"
receiptsrequired
Show item fields
createdDaterequired

Date the receipt was created

  • Format: date
Example"2024-06-15"
grossAmountrequired

Gross amount including VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
linesrequired
Show item fields
fulfilledQuantityrequired

Quantity fulfilled/picked

  • Format: BigDecimal
Example"2.0"
lineItemIdrequired

Reference to order line item

Example"01234567-89ab-cdef-0123-456789abcdef"
quantityrequired

Quantity invoiced

  • Format: BigDecimal
Example"2.0"
netAmountrequired

Net amount excluding VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"598.00"
refundsrequired
Show item fields
createdDaterequired

Date the refund was created

  • Format: date
Example"2024-06-20"
grossAmountrequired

Gross refund amount including VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"
grossReturnFeeAmountrequired

Gross return fee amount including VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"59.00"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
linesrequired
Show item fields
lineItemIdrequired

Reference to order line item

Example"01234567-89ab-cdef-0123-456789abcdef"
quantityrequired

Quantity refunded

  • Format: BigDecimal
Example"1.0"
netAmountrequired

Net refund amount excluding VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"598.00"
netReturnFeeAmountrequired

Net return fee amount excluding VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"47.20"
statusrequired

Refund status

Allowed values"OPEN""CLOSED"
shipmentsrequired
Show item fields
captureIdrequired

Reference to the capture (picking list) this shipment originated from

Example"01234567-89ab-cdef-0123-456789abcdef"
createdDateoptional

Date the shipment was created

  • Format: date
Example"2024-06-16"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
linesrequired
Show item fields
lineItemIdrequired

Reference to order line item

Example"01234567-89ab-cdef-0123-456789abcdef"
quantityrequired

Quantity shipped

  • Format: BigDecimal
Example"2.0"
trackingNumberoptional
Example"1Z999AA10123456784"
trackingUrloptional
Example"https://track.example.com/1Z999AA10123456784"
updatedAtrequired
  • Format: ISO 8681 timestamp
Example"2025-10-28T12:37:42Z"
vouchersrequired
Show item fields
externalReferencerequired

External reference for the voucher

Example"abc123-promo-uuid"
titleoptional

Display name for the voucher

Example"Summer Sale 20%"
typeoptional
Example"PERCENTAGE"
valueoptional
  • Format: BigDecimal
Example"20.00"
View raw schema
{
  "type": "object",
  "properties": {
    "captures": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/snowbee.SbPublicApiCaptureResponse"
      },
      "title": "List<SbPublicApiCaptureResponse>"
    },
    "currencyIsoCode": {
      "type": "string",
      "description": "ISO 4217 currency code",
      "example": "NOK",
      "title": "String"
    },
    "customerId": {
      "type": "string",
      "description": "Customer ID associated with the order",
      "example": "01234567-89ab-cdef-0123-456789abcdef",
      "title": "String"
    },
    "deliveryAddress": {
      "$ref": "#/components/schemas/snowbee.SbPublicApiDeliveryAddressResponse"
    },
    "externalOrderId": {
      "type": [
        "null",
        "string"
      ],
      "description": "External order ID from your e-commerce platform",
      "example": "SHOP-123",
      "title": "String"
    },
    "externalOrderNumber": {
      "type": [
        "null",
        "string"
      ],
      "description": "External order number displayed to customer",
      "example": "WEB-2024-00123",
      "title": "String"
    },
    "freight": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "$ref": "#/components/schemas/snowbee.SbPublicApiFreightResponse"
        }
      ]
    },
    "id": {
      "type": "string",
      "example": "01234567-89ab-cdef-0123-456789abcdef",
      "title": "String"
    },
    "invoiceAddress": {
      "$ref": "#/components/schemas/snowbee.SbPublicApiInvoiceAddressResponse"
    },
    "lineItems": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/snowbee.SbPublicApiOrderLineItemResponse"
      },
      "title": "List<SbPublicApiOrderLineItemResponse>"
    },
    "orderDate": {
      "type": "string",
      "format": "date",
      "description": "Date the order was placed",
      "example": "2024-06-15",
      "title": "LocalDate"
    },
    "orderNumber": {
      "type": "string",
      "description": "Human-readable order number",
      "example": "SO-2024-00123",
      "title": "String"
    },
    "orderStatus": {
      "$ref": "#/components/schemas/snowbee.SbPublicApiOrderStatus",
      "description": "Current status of the order"
    },
    "receipts": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/snowbee.SbPublicApiReceiptResponse"
      },
      "title": "List<SbPublicApiReceiptResponse>"
    },
    "refunds": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/snowbee.SbPublicApiRefundResponse"
      },
      "title": "List<SbPublicApiRefundResponse>"
    },
    "shipments": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/snowbee.SbPublicApiShipmentResponse"
      },
      "title": "List<SbPublicApiShipmentResponse>"
    },
    "updatedAt": {
      "type": "string",
      "format": "ISO 8681 timestamp",
      "example": "2025-10-28T12:37:42Z",
      "title": "ISO8681"
    },
    "vouchers": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/snowbee.SbPublicApiVoucherResponse"
      },
      "title": "List<SbPublicApiVoucherResponse>"
    }
  },
  "required": [
    "captures",
    "currencyIsoCode",
    "customerId",
    "deliveryAddress",
    "id",
    "invoiceAddress",
    "lineItems",
    "orderDate",
    "orderNumber",
    "orderStatus",
    "receipts",
    "refunds",
    "shipments",
    "updatedAt",
    "vouchers"
  ],
  "title": "SbPublicApiGetOrderResponse"
}