Métodos de frete

Um método de frete é uma forma de entrega que a loja oferece no checkout: "Motoboy", "Sedex", "Retirada na loja". O cadastro guarda o nome, a transportadora, o prazo, a faixa de peso e as tabelas de preço de cada método. Esta seção documenta as rotas que um sistema escrito para a Venddor 1.0 usa para ler e manter esse cadastro.

Como funciona

1. Cadastre o método

   Crie o método com POST /shippings, informando nome, transportadora e prazo. Ele nasce ativo se você não mandar o status.

2. Ajuste as tabelas de preço

   Envie rates e service_params na criação ou na alteração. Os campos são objetos livres, que a plataforma devolve como foram gravados.

3. Use no pedido

   O id do método é o shipping_id que o pedido e o envio (Envios do pedido) referenciam.

Conceitos

Status

Na escrita, qualquer valor diferente de A (sem diferenciar maiúscula) desativa o método.

Peso

min_weight e max_weight definem a faixa de peso atendida pelo método. 0 significa sem limite.

Rotas

Erros comuns

• Tratar a lista como filtrada no banco. A lista é montada inteira e a plataforma devolve só a janela pedida; o máximo por página é 250.
• Mandar position ou company_id e esperar que gravem. Esses campos são aceitos no corpo, mas a criação e a alteração os ignoram.
• Zerar o peso com 0 na alteração. Na alteração, pesos iguais a 0 são tratados como "não enviado".
• Achar que inactive e disabled são status diferentes. Qualquer valor diferente de A desativa; na leitura o valor volta sempre como A ou D.

Próximos passos