Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.Documentação do
Envios em pontos facultativos
Listar pontos facultativos
Os pontos facultativos podem ser obtidos com a seguinte chamada:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/seller/$SELLER_ID/working_day_middleend
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/seller/12345678/working_day_middleend
Resposta:
{
"dates": [
{
"finalized": false,
"closed": false,
"enabled": true,
"checked": true,
"description": "Día del perdón",
"date": "2022-09-26",
},
{
"finalized": false,
"closed": false,
"enabled": true,
"checked": true,
"description": "Día del perdón",
"date": "2022-09-27"
}
]
}
Campos de resposta:
- finalized: indica que o ponto facultativo acabou.
- closed: indica se esse dia está habilitado em sua página de configuração.
- enabled: indica se deve mostrar habilitado ou não o ponto facultativo.
- checked: indica se o checkbox deve estar marcado ou não.
- description: nome do ponto facultativo.
- date: data no formato yyyy-mm-dd do ponto facultativo.
Atualizar ponto facultativo
Para atualizar o ponto facultativo, você deve fazer a seguinte chamada:
Chamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/seller/$SELLER_ID/working_day_middleend
{
"site_id": "MLA",
"dates":[
{
"checked": true,
"description": "Día del perdón",
"date": "2022-09-26"
},
{
"checked": true,
"description": "Día del perdón",
"date": "2022-09-27"
}
]
}
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/seller/12345678/working_day_middleend
{
"site_id": "MLA",
"dates":[
{
"checked": true,
"description": "Día del perdón",
"date": "2022-09-26"
},
{
"checked": true,
"description": "Día del perdón",
"date": "2022-09-27"
}
]
}
Resposta Status 200 OK:
"all working days were saved"
Campo de resposta:
- checked: caso seja true, o vendedor não trabalha no dia.
- description: nome do ponto facultativo.
- date: data no formato yyyy-mm-dd do ponto facultativo.
Busca por pontos facultativos
Conhecida a data é possível pesquisar o dia não útil. Para isso você deve fazer a seguinte chamada:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/seller/$SELLER_ID/working_day_middleend/optout?date=AAAA-MM-DD
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/seller/$SELLER_ID/working_day_middleend/optout?date=2022-10-17
Resposta:
{
"dates": [
{
"description": "Día del perdón",
"date": "2022-09-26",
}
]
}
Se o vendedor não tiver nenhum dia configurado, o recurso retornará uma resposta vazia com status 200 na chamada.
Caso não conheça o ponto facultativo, com o mesmo recurso (sem usar o parâmetro date), pode conhecer os pontos facultativos configurados pelo vendedor.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/seller/$SELLER_ID/working_day_middleend/optout
Resposta:
{
"dates": [
{
"description": "Día del perdón",
"date": "2022-09-26",
}
]
}