Metafields de pedidos

Zonos escreve os detalhes do pedido em metafields de pedidos de Shopify sob o namespace zonos. Isso dá acesso direto aos IDs de pedidos de Zonos, a desagregações de custos por artigo e subtotais de direitos aduaneiros/impostos/taxas sem necessidade de chamar a API de Zonos separadamente.

Estes metafields estão disponíveis em cada pedido de Shopify processado através de Zonos e podem ser consultados através da Shopify Admin API, Shopify Flow ou qualquer ferramenta que leia metafields de pedidos.

Metafields disponíveis 

Zonos escreve três metafields em cada pedido de Shopify, todos sob o namespace zonos.

zonos_id

O ID de pedido único de Zonos ligado a este pedido de Shopify. Use este ID para procurar o pedido completo em Zonos Dashboard ou através da API de Zonos.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Um objecto JSON que contém os totais agregados de direitos aduaneiros, impostos, taxas e envio do pedido.

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

zonos_items

Um array JSON que contém desagregações de custos por artigo. Cada artigo inclui montantes tanto na moeda paga pelo cliente como na moeda base da sua loja.

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

Aceder aos metafields 

Pode aceder a estes metafields através de qualquer método que suporte a leitura de metafields de pedidos de Shopify:

• Shopify Admin API (GraphQL ou REST)
• Shopify Flow para automatizar fluxos de trabalho baseados em dados de pedidos de Zonos
• Aplicações de terceiros que leiam metafields de pedidos (por exemplo, ferramentas de relatórios, ERPs)

Exemplo: Consulta por Shopify GraphQL API

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