Metafields de pedidos

Zonos escribe los detalles del pedido en metafields de pedidos de Shopify bajo el namespace zonos. Esto le da acceso directo a los ID de pedidos de Zonos, desgloses de costos por artículo y subtotales de aranceles/impuestos/tarifas sin necesidad de llamar a la API de Zonos por separado.

Estos metafields están disponibles en cada pedido de Shopify procesado a través de Zonos y pueden consultarse mediante la Shopify Admin API, Shopify Flow o cualquier herramienta que lea metafields de pedidos.

Metafields disponibles 

Zonos escribe tres metafields en cada pedido de Shopify, todos bajo el namespace zonos.

zonos_id

El ID de pedido único de Zonos vinculado a este pedido de Shopify. Utilice este ID para buscar el pedido completo en Zonos Dashboard o mediante la API de Zonos.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Un objeto JSON que contiene los totales agregados de aranceles, impuestos, tarifas y envío del pedido.

{
  "duties": 0,
  "taxes": 400.39,
  "fees": -78.93,
  "shipping": 966.87
}

zonos_items

Un array JSON que contiene desgloses de costos por artículo. Cada artículo incluye montos tanto en la moneda pagada por el cliente como en la moneda base de su tienda.

[
  {
    "amount": 830.53,
    "productId": "49380521509183",
    "currencyCode": "CAD",
    "paidAmount": {
      "amount": 830.53,
      "currencyCode": "CAD"
    },
    "shopAmount": {
      "amount": 606.85,
      "currencyCode": "USD"
    }
  }
]

Acceder a los metafields 

Puede acceder a estos metafields mediante cualquier método que admita la lectura de metafields de pedidos de Shopify:

• Shopify Admin API (GraphQL o REST)
• Shopify Flow para automatizar flujos de trabajo basados en datos de pedidos de Zonos
• Aplicaciones de terceros que lean metafields de pedidos (p. ej., herramientas de informes, ERPs)

Ejemplo: Consulta mediante Shopify GraphQL API

query OrderZonosMetafields($orderId: ID!) {
  order(id: $orderId) {
    metafields(namespace: "zonos", first: 10) {
      edges {
        node {
          key
          value
        }
      }
    }
  }
}