Pular para o conteúdo principal

Hub — Pedidos

📄️Envia NF do pedido para o canal

Envia ao canal o documento fiscal do pedido faturado — vários canais exigem isso para o pedido seguir para Enviado. O parâmetro `Type` troca a ação disparada: marcar como enviado, marcar como entregue, atualizar as tarifas e o valor líquido do canal ou reprocessar o fluxo de pedido full. Omitido, envia a NF. Em caso de sucesso a resposta normalmente vem com corpo vazio, mas em algumas situações o canal devolve um aviso curto em texto puro — por exemplo `Pedido ja enviado` ou `status já está pronto para imprimir` — ainda com `200`. A chamada aguarda a resposta do canal por tempo limitado; esgotado esse prazo a API responde `200` com corpo vazio sem que a ação tenha sido confirmada, então confirme o resultado consultando o pedido.

📄️Consulta status atualizado do pedido no canal

Consulta o status do pedido diretamente no canal e sincroniza a linha de staging com o resultado — útil quando a atualização periódica não trouxe a mudança. Quando o canal devolve o pedido como pago, o valor sincronizado e retornado passa a ser o status do envio (`ready_to_ship`, `shipped`, `delivered`…), permanecendo `paid` enquanto o envio ainda estiver pendente. Além de atualizar o status, marca o pedido idworks como entregue quando o canal já registrou a entrega. No cancelamento a ação depende da origem do estoque: pedidos atendidos pelo armazém do canal (full) são reprocessados pelo fluxo de pedido full, e os demais são cancelados no idworks quando a integração está configurada para cancelamento automático.

📄️Lista reclamações abertas pelos compradores

Lista as reclamações sincronizadas dos canais, da mais recente para a mais antiga, em páginas de até 2000 registros. Cada linha traz estágio, tipo, motivo e motivo de resolução vindos do canal — as listas auxiliares estão em `/type/hub/order/claim/{reason,stage,type,resolution-reason}`. Os pares de data `DateFrom`/`DateTo` e `DueDateFrom`/`DueDateTo` só filtram quando os dois extremos são enviados; sozinho, cada um é ignorado. O código `ClaimAffectsReputation` NÃO é booleano: `1` = NÃO afeta, `2` = AFETA, `3` = não se aplica, `0` = o canal respondeu sem informar e `null` = a consulta de reputação ao canal falhou. Prefira `ClaimAffectsReputationDescription`, que já vem com o texto resolvido — `Não afeta reputação`, `Afeta reputação` ou `Não se aplica` — e vem `null` nos dois estados indeterminados (`0` e `null`); ler o código como verdadeiro/falso inverte o resultado.

Última atualização em