VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API legada/Referência completa/Remessas

Campos de remessa

Referência de todos os campos de um objeto de remessa, com descrição, valor padrão e valores aceitos.

Uma remessa na API da Venddor tem várias propriedades, representadas por campos. Esta página é a lista de todos os campos aceitos, com as descrições, os valores padrão e os tipos de dados aceitos.

Atenção

Os campos obrigatórios são marcados com o símbolo *. Qualquer campo que não esteja na tabela abaixo é ignorado se você o incluir numa requisição da API.

Campos da remessa

A tabela a seguir lista todos os campos disponíveis dos objetos de remessa.

Nome do campoDescriçãoValor padrãoValores aceitos
carrier*Nome da transportadora''Nome válido de transportadora
order_id*Id do pedidon/dId de pedido válido
products*Produtos enviadosn/dObjeto JSON com o id do item do carrinho como chave e a quantidade dele como valor
shipping*Nome da forma de envio'Custom shipping method'Nome válido de forma de envio
shipping_id*Id da forma de envio1Id válido de forma de envio
user_id*Id de usuário do clienten/dId de usuário válido
tracking_numberCódigo de rastreamento''string
commentsComentários sobre a remessa''string
group_keyChave do grupo de fornecedoresDefinido automaticamenteChave de grupo de fornecedores válida
order_timestampTimestamp de criação do pedidoDefinido automaticamenteTimestamp válido no formato UNIX
Dica

Informe sempre um código de rastreamento ao criar remessas. Ele dá à sua empresa e aos seus clientes melhores condições de acompanhar a entrega.

Exemplo de requisição de remessa

json
{
  "carrier": "FedEx",
  "order_id": 78924,
  "products": {
    "467": 2,
    "589": 1
  },
  "shipping": "Express Shipping",
  "shipping_id": 3,
  "user_id": 12453,
  "tracking_number": "FDX783945201847",
  "comments": "Customer requested delivery to back door"
}

Endpoints de remessas na API

Esta página lista quatro endpoints. Todos eles são descritos, com exemplos, na página Endpoints.

MétodoCaminhoDescrição
GET/api/shipmentsRetorna uma lista de todas as remessas
GET/api/shipments/{id}Retorna os detalhes de uma remessa específica, pelo id
POST/api/shipmentsCria uma remessa nova com as informações enviadas
PUT/api/shipments/{id}Atualiza uma remessa existente com as informações enviadas
Atenção

Ao criar uma remessa, confirme que todos os produtos citados nela fazem parte do pedido informado.

Veja também

  • Visão geral de remessas
  • Endpoints de remessas
Anterior
Paginação de remessas
Próxima
Status
Nesta página
  • Campos da remessa
  • Exemplo de requisição de remessa
  • Endpoints de remessas na API
  • Veja também