Preparar a entrada da mutação
A mutação orderCreate
requer dados de entrada específicos. Embora campos adicionais opcionais estejam disponíveis, os seguintes campos são obrigatórios:
currencyCode
: A moeda em que o pedido foi realizado.landedCostId
: O ID da cotação de landed cost usada no pedido.accountOrderNumber
: O número do pedido que você atribui (geralmente o número do pedido da plataforma). Cada número de pedido deve ser único dentro de uma organização.
Você pode criar vários pedidos usando o mesmo landedCostId
, mas na maioria das circunstâncias, as cotações de landed cost não podem ser usadas por mais de 90 dias. Usar uma cotação de landed cost com mais de 90 dias geralmente anula a garantia de landed cost para esse pedido.
Enviar a mutação
Uma vez que você tenha os dados de entrada necessários, envie a mutação GraphQL para o endpoint da API usando a biblioteca ou ferramenta de cliente de sua escolha. Aqui está um exemplo de como você pode estruturar a mutação:
Use esta mutação quando você estiver criando um pedido com base em uma cotação de landed cost.
Mutação
mutation {
orderCreate(
input: {
accountOrderNumber: "12343244"
billTo: "party_00e63a9e-9735-44d9-b129-3b3e76c5df25"
currencyCode: USD
grandTotal: 2346.12
landedCostId: "landed_cost_32e7f442-8e82-47b3-957a-096088b14e7b"
}
) {
id
organization
landedCosts {
id
}
}
}
Resposta
{
"data": {
"orderCreate": {
"id": "order_ec7084f6-0778-47ce-b848-3ba57af9684d",
"organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0",
"landedCosts": [
{
"id": "landed_cost_32e7f442-8e82-47b3-957a-096088b14e7b"
}
]
}
}
}
Criar pedidos
Aprenda como criar pedidos a partir de uma cotação de landed cost.
GraphQL
Uma vez que você tenha criado ou calculado um
landedCost
, você deve usar a mutaçãoorderCreate
para vincular a cotação delandedCost
que você recebeu a um pedido, o que habilitará nossa garantia de Landed Cost. Uma vez que um pedido é criado, a Zonos taxa será cobrada.