Exceções de remessa
Lista as remessas paradas ou com problema reportado pela transportadora e arquiva uma exceção já tratada.
O rastreamento automático consulta as transportadoras e marca como exceção a remessa que a transportadora reportou com problema (endereço não localizado, extravio) e como parada (stale) a que ficou sem movimento por tempo demais. A fila reúne as duas para a equipe agir: ligar para a transportadora, avisar o cliente, reenviar.
Listar exceções
/api/v1/admin/shipping/exceptionsAdminLista a fila de exceções de remessa
Exige view_shipping ou manage_shipping.
Parâmetros de consulta
pageintegerpadrão: 1Exemplo de requisição
Resposta
Campos da resposta
exceptionsarrayRemessas da página. null quando a fila está vazia.
shipment_iduuidorder_numberstringtracking_codestringtracking_statestringexceptionstaleexception ou stale.last_event_typestringage_hoursnumbertotalintegerpageintegerper_pageintegertotal_pagesintegerResolver uma exceção
Depois de tratar o caso, resolva a exceção para tirá-la da fila. A remessa passa a constar como entregue no rastreamento (tracking_state: delivered). Isso é só um arquivamento: o status do pedido, a expedição e a transportadora não são alterados.
/api/v1/admin/shipping/exceptions/{shipmentId}/resolveAdminResolve uma exceção de remessa
Exige manage_shipping. Sem corpo.
Parâmetros de caminho
shipmentIduuidobrigatórioshipment_id da fila).Exemplo de requisição
Resposta
Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Sem token, token inválido ou expirado | {"error":"invalid or expired token"} |
| 403 | Sem o privilégio exigido | {"error":"insufficient privileges","privilege_required_any":["manage_shipping"]} |
| 500 | shipmentId que não é UUID; falha interna | {"error":"resolve_failed","detail":"o valor \"abc\" não é um uuid válido..."} / {"error":"exceptions_failed","detail":"..."} |