Pular para o conteúdo principal

Gestão de pedidos agendados

O ANYMARKET agora oferece suporte para que você possa acompanhar a data de disponibilização de produtos fabricados sob demanda (crossdocking) e informar via API quando o produto estiver pronto para envio, para que possa enviar a nota fiscal e solicitar a etiqueta.

aviso

Atenção!

Apenas o marketplace MERCADO LIVRE disponibiliza a atencipação de pedidos agendados.

Como era antes?

Anteriormente, para indicar que um produto já estava disponível antes da data limite, era necessário que o vendedor acessasse manualmente o painel do Mercado Livre e clicasse no botão "Já estou com o produto".

O que mudou?

Agora, você pode informar via API que o produto está pronto, diretamente pela atualização de pedidos (PUT /orders/) usando o campo deliveryStatus.

Consultar Data de Disponibilização (Agendamento)

Para pedidos com produtos em fabricação, é possível consultar a data limite para disponibilização do produto.

Utilize o endpoint:

GET /orders/{id}

A data estará disponível no campo bufferingDate, dentro do objeto tracking.

Exemplo de resposta:

"tracking": {
"number": "MEL4510070728234XDF01",
"carrier": "MEL Distribution",
"estimateDate": "2025-07-06T03:00:00Z",
"bufferingDate": "2025-07-03T23:59:59Z"
}

bufferingDate indica a data até a qual o produto deve estar disponível para envio.

Marcar Produto como Pronto para Envio

Se você já está com o produto antes da data de agendamento e deseja antecipar o envio, é possível informar essa condição diretamente via API.

Utilize o endpoint:

PUT /orders/{id}

E envie no corpo da requisição o campo deliveryStatus com o valor "SHIP_CONFIRMED":

Exemplo de requisição:

PUT /orders/123456
{
"deliveryStatus": "SHIP_CONFIRMED"
}

Comportamento esperado:

  • A chamada de atualização retorna sucesso.

  • A ação será processada de forma assíncrona.

  • Se a antecipação for aceita, o status do pedido será atualizado normalmente.

  • Caso ocorra algum erro na operação, o pedido será marcado com erro.

Mensagens de erro:

Para identificar se a operação foi concluída com sucesso, faça uma nova consulta ao pedido com:

GET /orders/{id}

Se a tentativa de antecipação falhar, o pedido será retornado com os seguintes campos:

"transmissionStatus": "ERROR",
"transmissionMessage": "Erro ao informar que já possui o produto, aguarde a data limite de fabricação ou tente novamente."

Resumo

AçãoEndpointCampo
Ver data de agendamentoGET /orders/{id}tracking.bufferingDate
Informar que está com o produtoPUT /orders/{id}"deliveryStatus": "SHIP_CONFIRMED"
Verificar erro na requisiçãoGET /orders/{id}transmissionStatus, transmissionMessage