Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 22/12/2023

Envios Flex

Importante:
Atualmente, este método de envio está disponível para vendedores na Argentina, Brasil, México, Chile, Colômbia, Uruguai, Peru e Equador.

Flex Shipping é um serviço que permite aos vendedores enviar por conta própria, 7 dias por semana. Integre a remessa no mesmo dia ou no dia seguinte para melhorar os prazos de entrega e aumentar a penetração no mercado. Com o Flex Shipping, os vendedores podem ter maior controle e rastreamento de suas remessas, oferecendo um atendimento mais rápido e eficiente aos seus clientes.
Saiba mais sobre os benefícios do Flex Shipping, como funciona o Envios Flex e como ativar o Flex para vendedores. Da mesma forma, se o vendedor também envia integralmente, saiba como oferecer Envios Flex e Full na mesma publicação e sobre Gestão de Estoque na coexistência de Full e Flex.

Nota:
  • É fundamental respeitar o limite de 1000 rpm para todas as chamadas aos recursos FLEX. A manutenção deste limite garante uma utilização eficiente e equitativa dos recursos disponíveis.
  • O aplicativo de envios flex Mercado Livre é necessário para digitalizar entregas e fazer rotas de entrega. Porém, não está disponível para integrações, portanto as empresas de logística terão que se adaptar.

Áreas de cobertura por países

Para oferecer envios flex, o endereço de entrega do vendedor deve estar habilitado para uma das áreas de cobertura segundo o país:

País Cobertura
Argentina - AMBA (Área Metropolitana de Buenos Aires)
- Córdoba
Brasil - São Paulo
- Rio de Janeiro
- Brasília
- Belo Horizonte
- Porto Alegre
- Salvador Bahia
- Curitiba
México - CDMX (Zona Metropolitana do Vale do México)
- Mérida
Chile - Santiago (Região Metropolitana)
- Valparaíso
Colômbia - Bogotá
- Medellín
- Cali
Uruguai - Montevideo
- Canelones
Peru - Lima (Área Metropolitana)
Equador - Quito


Configurar um usuário de teste

Para configurar a funcionalidade de Envios Flex para usuários de prova, leve em conta:


1. Faça login na conta onde deseja ativar o Envios Flex
2. Certifique-se de que a conta tenha postagens ativas no ME2.
3. Verifique se sua conta tem reputação Amarela ou Verde.
4. Certifique-se de ter um endereço de e-mail compatível com a área de cobertura do seu país.
5. Defina o endereço de entrega de acordo com as áreas de cobertura dos países correspondentes.
6. Ative o envio flexível para a conta.


Depois de concluir esses passos, você poderá usar o Envios Flex como usuário de teste.

Nota:
    É recomendável criar um novo usuário de teste com a nova configuração para testar este fluxo atualizado.

Consultar assinaturas de um usuário

Este endpoint permite consultar as assinaturas que um usuário possui.

  • Se o usuário ativou apenas o Flex, ele terá uma única assinatura.
  • Caso o usuário também tenha ativado o Turbo, ele terá duas assinaturas, pois para ativar o Turbo o usuário deve primeiro ter o Flex ativo.
Nota:
  • Se cria uma assinatura quando um vendedor começa a usar o Envios Flex em qualquer modo.
  • No contexto das assinaturas, cada assinatura possui um identificador exclusivo denominado service_id. Este identificador é essencial para poder acessar e fazer alterações nas configurações de assinatura. Neste caso, o que será utilizado será o service_id do modo Flex.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/$SITE_ID/users/$USER_ID/subscriptions/v1

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/MLA/users/1438865529/subscriptions/v1

Resposta:

[
    {
        "id": 111181,
        "site_id": "MLA",
        "user_id": 1438865529,
        "mode": "FLEX",
        "configuration_type": {
            "coverage": "zone",
            "delivery": "custom"
        },       
        "service_id": 736230,
        "status": {
            "id": "in",
        },
        "creation_date": "2023-08-02T06:34:40Z"
    },
    {
        "id": 111183,
        "site_id": "MLA",
        "user_id": 1438865529,
        "mode": "TURBO",
        "configuration_type": {
            "coverage": "radius",
            "delivery": "accurate" 
        },  
        "service_id": 738216,
        "status": {
            "id": "in",
        },
        "creation_date": "2023-08-02T06:35:30Z"
    }
]

Parâmetros de resposta:

id: ID único da inscrição.
site_id: Identificador do país.
user_id: ID do usuário.
mode: Tipo de inscrição(FLEX neste caso).
configuration_type: Tipo de configuração da inscrição (FLEX neste caso).br/> configuration_type.coverage: Tipo de cobertura.
configuration_type.delivery: Tipo de entrega.
service_id: ID do serviço associado à sua inscrição.
status: Estado da inscrição.
status.id: Tipos de estados da inscrição:

  • in: A assinatura está ativa. Neste estado o usuário poderá alterar suas configurações e receber pedidos de envio para modalidade de assinatura.
  • out: A inscrição não está ativa. Neste estado o usuário não pode mudar a configuração.
  • pending: A assinatura está com ativação pendente. Neste estado o usuário pode alterar sua configuração embora não receba pedidos para fazer envios.
creation_date: Data de criação da inscrição.


Códigos de estado de resposta:

Código Mensagem Descrição Recomendação
200 - OK - Atualizou corretamente a configuração -
400 - Bad Request empty site id O site_id está vazio Validar o site_id
400 - Bad Request invalid site_id Site_id inválido Validar se o site_id está habilitado para Envios Flex
400 - Bad Request can't access to resource Site_id inválido Validar se o site_id está habilitado para Envios Flex
404 - Not Found user not found Não existe o usuário Validar o user_id


Consultar a configuração da inscrição

Este endpoint permite consultar a configuração das inscrição que tem um usuário, para este caso de flex.


Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/$SITE_ID/configuration/v3

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/MLA/configuration/v3

{
  "query": "{ configuration (user_id: 1438865529, service_id: 736230) { address { id address_line city { id name } zip_code } subscription { site_id user_id service_id status { id } creation_date training_times { original { value unit } remaining { value unit } activation_date } } delivery_window is_moderated delivery_ranges { week { capacity type processing_time from to et_hour calculated_cutoff } saturday { capacity type processing_time from to et_hour calculated_cutoff } sunday { capacity type processing_time from to et_hour calculated_cutoff } } working_days zones { enabled id is_mandatory label neighborhoods price { cents currency_id decimal_separator fraction symbol } selected } availables { cutoff capacity_range { from to } ranges } disabled_features } }"
}

Resposta:


{
    "configuration": {
        "address": {
            "address_line": "Testing Street 1450",
            "city": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "id": "1316123989",
            "zip_code": "1430"
        },
        "availables": {
            "capacity_range":  {
               "from": 1,
               "to": 50
            },
            "cutoff": [
                12,
                13,
                14,
                15,
                16,
                17,
                18
            ],
            "ranges": [
                9,
                10,
                11,
                12,
                13,
                14,
                15,
                16,
                17,
                18,
                19,
                20,
                21
            ]
        },
        "delivery_ranges": {
            "saturday": null,
            "sunday": null,
            "week": [
                {
                    "calculated_cutoff": 14,
                    "capacity": 30,
                    "et_hour": 14,
                    "from": 12,
                    "processing_time": 0,
                    "to": 21,
                    "type": "cpt"
                }
            ]
        },
        "delivery_window": "same_day",
        "disabled_features": [
            "CUTOFF_BY_ZONE",
            "CAPACITY_BY_DAY"
        ],
        "is_moderated": false,
        "subscription": {
            "creation_date": "2023-08-02T06:34:40Z",
            "service_id": 736230,
            "site_id": "MLA",
            "status": {
                "id": "in"
            },
            "training_times": null,
            "user_id": 1438865529
        },
        "working_days": [
            "week"
        ],
        "zones": [
            {
                "enabled": true,
                "id": "Almirante_Brown",
                "is_mandatory": false,
                "label": "Almirante Brown",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Avellaneda",
                "is_mandatory": false,
                "label": "Avellaneda",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Berazategui",
                "is_mandatory": false,
                "label": "Berazategui",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "CABA",
                "is_mandatory": false,
                "label": "CABA",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1114",
                    "symbol": "$"
                },
                "selected": true
            },
            {
                "enabled": true,
                "id": "Esteban_Echeverria",
                "is_mandatory": false,
                "label": "Esteban Echeverría",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Ezeiza",
                "is_mandatory": false,
                "label": "Ezeiza",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Florencio_Varela",
                "is_mandatory": false,
                "label": "Florencio Varela",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Hurlingham",
                "is_mandatory": false,
                "label": "Hurlingham",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Ituzaingo",
                "is_mandatory": false,
                "label": "Ituzaingó",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Jose_C_Paz",
                "is_mandatory": false,
                "label": "José C Paz",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Lanus",
                "is_mandatory": false,
                "label": "Lanús",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Lomas_de_Zamora",
                "is_mandatory": false,
                "label": "Lomas de Zamora",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Malvinas_Argentinas",
                "is_mandatory": false,
                "label": "Malvinas Argentinas",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "La_Matanza_1",
                "is_mandatory": false,
                "label": "La Matanza Norte",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "La_Matanza_2",
                "is_mandatory": false,
                "label": "La Matanza Sur",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Merlo",
                "is_mandatory": false,
                "label": "Merlo",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Moreno",
                "is_mandatory": false,
                "label": "Moreno",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Moron",
                "is_mandatory": false,
                "label": "Morón",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Quilmes",
                "is_mandatory": false,
                "label": "Quilmes",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "San_Fernando",
                "is_mandatory": false,
                "label": "San Fernando",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "San_Isidro",
                "is_mandatory": false,
                "label": "San Isidro",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "San_Martin",
                "is_mandatory": false,
                "label": "San Martín",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "San_Miguel",
                "is_mandatory": false,
                "label": "San Miguel",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Tigre",
                "is_mandatory": false,
                "label": "Tigre",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "2409",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Tres_De_Febrero",
                "is_mandatory": false,
                "label": "Tres de Febrero",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            },
            {
                "enabled": true,
                "id": "Vicente_Lopez",
                "is_mandatory": false,
                "label": "Vicente López",
                "neighborhoods": [],
                "price": {
                    "cents": "99",
                    "currency_id": "ARS",
                    "decimal_separator": ".",
                    "fraction": "1769",
                    "symbol": "$"
                },
                "selected": false
            }
        ]
    }
}

Parâmetros de resposta:

address: Informação sobre a direção do usuário.
availables: Contém informação sobre a capacidade, turnos e intervalos disponíveis para o serviço.

  • availables.capacity_range: faixa de valores para capacidade.
  • availables.cutoff: Detalhe dos turnos disponíveis.
  • availables.ranges: Detalhe dos intervalo disponíveis.
delivery_ranges: Informação sobre a capacidade, turnos e intervalos disponíveis para os diferentes dias da semana.
  • delivery_ranges.saturday: Intervalo de entrega e capacidade para os sábados.
  • delivery_ranges.sunday: Intervalo de entrega e capacidade para os domingos.
  • delivery_ranges.week: Intervalos de entrega e capacidade para os dias da semana.
delivery_window: O tipo de serviço para a entrega. Os valores possíveis são same_day (envios no dia) ou next_day (envios ao dia seguinte).

disabled_features: Características desabilitadas para o serviço, incluindo CUTOFF_BY_ZONE e CAPACITY_BY_DAY.
is_moderated: Indica se o serviço está moderado (true/false).
subscription: Informação sobre a inscrição do usuário.
working_days: Dias úteis disponíveis.
zones: informação sobre as zonas disponíveis para o serviço.

  • zones.selected: Indica se a zona está selecionada (true/false).


Códigos de Estado de resposta:

Código Mensagem Descrição Recomendação
200 - OK - Atualizou corretamente a configuração. -
400 - Bad Request empty site id O site_id está vacío Validar o site_id
400 - Bad Request invalid site_id Site_id inválido Validar se o site_id está habilitado para Envios Flex.
400 - Bad Request can't access to resource Site_id inválido Validar se o site_id está habilitado para Envios Flex.
400 - Bad Request invalid JSON body O JSON é inválido. Validar o esquema de query estabelecido.
400 - Bad Request failed to create schema in graphql operation GraphQL inválida para o esquema definido. Validar o esquema de query estabelecido.
400 - Bad Request invalid query GraphQL inválida para o esquema definido. Validar o esquema de query estabelecido.
404 - Not Found subscriptions not found Não existe assinatura a Envios Flex para a combinação de user_id e service_id enviada. Validar o user_id e service_id no endpoint.
404 - Not Found user not found Não existe o usuário. Validar o user_id .


Nota:
Este endpoint é utilizado para validar os atributos com seus valores possíveis. Se desejar alterar ou modificar algum desses atributos, é recomendável utilizar os endpoints descritos em Configurar Prazo de Entrega e Limite de Envios ou Expandir Área de Cobertura Flex.

Configurar Prazo de Entrega e Limite de Envios

Através deste endpoint, é possível configurar diferentes aspectos para Envios Flex como:

  • Janela de Entrega
  • Intervalo de Horário de Entrega
  • Horário de Turnos
  • Limite de envios


Chamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/$SITE_ID/users/$USER_ID/services/$SERVICE_ID/configuration/delivery/custom/v3

Exemplo:


curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/MLA/users/1438865529/services/736230/configuration/delivery/custom/v3

{
        "delivery_window": "same_day",
        "delivery_ranges": {
            "week": [
                {   
                    "from": 12,
                    "to": 21,
                    "capacity": 44,
                    "cutoff": 16
                }
            ],
            "saturday": [
                {
                    "from": 12,
                    "to": 21,
                    "capacity": 33,
                    "cutoff": 14
                }
            ],
            "sunday": [
                { 
                    "from": 12,
                    "to": 21,
                    "capacity": 33,
                    "cutoff": 14
                }
            ]
        }
}
Nota:
  • O delivery_window sempre é necessário ao alterar qualquer configuração.
  • Os Intervalos Horários de Entrega para dias de semana, sábado e domingo indica a partir de que horas (de) e até que horas (para) os envios são feitos. Esses valores deverão ser enviados em:

    • - delivery_ranges.week.from e delivery_ranges.week.to
    - delivery_ranges.saturday.from e delivery_ranges.saturday.to (se trabalha nos sábados)
    - delivery_ranges.sunday.from e delivery_ranges.sunday.to (se trabalha nos domingos)
    - O from e o to sempre são requeridos ao mudar qualquer configuração.


  • O valor de Capacidade (limite de envios) deve enviar em:

    • - delivery_ranges.week.capacity
    - delivery_ranges.saturday.capacity (se trabalha nos sábados)
    - delivery_ranges.sunday.capacity (se trabalha nos domingos)
    - Atualmente, a API só suporta o mesmo valor para os 3 casos.


  • O valor de Cutoff Geral deve enviar em:

- delivery_ranges.week.cutoff
- delivery_ranges.saturday.cutoff (se trabalha nos sábados)
- delivery_ranges.sunday.cutoff (se trabalha nos domingos)
-O cutoff sempre é requerido ao mudar qualquer configuração.


Códigos de estado de resposta:

Código Mensagem Descrição Recomendação
200 - OK - Atualizou corretamente a configuração. -
400 - Bad Request invalid user_id User_id inválido. Validar user_id (deve ser um número inteiro).
400 - Bad Request invalid service_id Service_id inválido. Validar o service_id (deve ser um número inteiro).
400 - Bad Request invalid JSON body O JSON é inválido. Validar o esquema de query estabelecido.
404 - Not Found can't update delivery custom Não pode realizar a atualização de configuração devido a não existir assinatura a Envios Flex para a combinação de user_id y service_id enviada. Validar o user_id e service_id no endpoint.


Ampliar área de cobertura Flex

Este endpoint permite adicionar mais áreas de coberturas para Envios Flex.

chamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/$SITE_ID/users/$USER_ID/services/$SERVICE_ID/configuration/coverage/zone/v3

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/MLA/users/1438865529/services/736230/configuration/coverage/zone/v3

{
  "zones": [
    {
      "id": "Almirante_Brown"
    },
    {
      "id": "Avellaneda"
    },
    {
      "id": "CABA" 
    }
  ]
}

Códigos de Estado de resposta:

Código Mensagem Descrição Recomendação
200 - OK - Atualizou corretamente a configuração. -
400 - Bad Request invalid user_id User_id inválido. Validar o user_id (deve ser um número inteiro).
400 - Bad Request invalid service_id Service_id inválido. Validar o service_id (deve ser um número inteiro).
400 - Bad Request invalid JSON body O JSON é inválido. Validar o esquema de query estabelecido
404 - Not Found can't update delivery custom Não pode realizar a atualização de configuração devido a não existir inscrição a Envios Flex para a combinação de user_id e service_id enviada. Validar o user_id e service_id no endpoint.


Nota:
Para adicionar ou excluir zonas Flex, é necessário usar o método PUT e enviar a lista correspondente de zonas.

Consultar Flex no item

Este endpoint te permite consultar se o item está habilitado para Envios Flex ou não.


chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/shipping/selfservice/items/$ITEM_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/shipping/selfservice/items/MLB1493119403

Resposta:

Status: 204 No Content

Códigos de Estado de resposta:

Código Mensagem Descrição Recomendação
204 - No Content - Item habilitado para Envios Flex. -
403 - Forbidden item down Item não oferece Envios Flex. Validar as modalidades de envio do Item.
404 - Not Found item not found O país está desabilitado para Envios Flex. Validar os países com Envios Flex.


Nota:
O endpoint /itens oferece informação relevante sobre o item, como:
  • O atributo tags que fornece detalhes adicionais sobre se o item tem ativo Envíos Flex (self_service_in) ou não (self_service_out).

Ativar Flex no item

Este endpoint permite ativar a opção de Envíos Flex ao item.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/shipping/selfservice/items/$ITEM_ID

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/shipping/selfservice/items/MLB1493119403

Resposta:

Status: 204 No Content
Código Mensagem Descrição Recomendação
204 - No Content - Item atualizado corretamente para oferecer Envios Flex. -
400 - Bad Request item is already in flex Item já se encontra com Envios Flex. -
403 - Forbidden item down O Item não oferece Envios Flex. Validar as modalidades de envio do ítem.
404 - Not Found item not found Item não encontrado. Validar os países com Envios Flex.


Consultar estado do item

Antes de ativar Flex em um item, você deve realizar uma validação para garantir que o item está com estado 'active'. Isto pode ser verificado pelo endpoint para obter um item e depois consultar o atributo 'status'.


Chamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items?ids=$ITEM_ID&attributes=status

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items?ids=MLA1136716168&attributes=status

Resposta:

[
...
    "status": "active",
...
    ]
Nota:
Este processo de validação é essencial para garantir que “Flex” seja ativo corretamente quando o item esteja no estado adequado.
Para maior referência revise Publicar produtos y Busca de itens.

Desativar Flex no item

Este endpoint permite desativar a opção de Flex no item.

Chamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/shipping/selfservice/items/$ITEM_ID

Exemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/shipping/selfservice/items/MLB1493119403

Resposta:

Status: 204 No Content

Códigos de Estado de resposta:

Código Mensagem Descrição Recomendação
204 - No Content - Item atualizado corretamente para deixar de oferecer Envios Flex. -
400 - Bad Request item is already in flex Item já não conta com Envios Flex. -
403 - Forbidden item down Item não oferece Envios Flex. Validar as modalidades de envio do item.
404 - Not Found item not found Item não encontrado. Validar os países com Envios Flex.


Identificar o código da transportadora

Este endpoint facilita a identificação da transportadora destinada a um envio, o que é útil para registrar mudanças de transportadora durante o processo de entrega.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/flex/sites/$SITE_ID/shipments/$SHIPMENT_ID/assignment/v1

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 
https://api.mercadolibre.com/flex/sites/MLA/shipments/40070866801/assignment/v1

Resposta:

{
    "driver_id": 1234
}

Códigos de Estado de resposta:

Código Mensagem Descrição Recomendação
200 - OK - Transportadora designada. -
404 - Not Found shipment_id not found Não possui transportadora designada ou não se encontra a rota aberta (envio pendente a ser entregue).
Não existe (shipment inexistente). 		Validar o estado do envio ou shipment_id.


Nota:
  • Para a Argentina, no caso em que as coletas sejam realizadas fora do endereço do vendedor, o motorista terá que inserir o token alfanumérico válido que o vendedor pode fornecer. Para encontrar o código, o vendedor deve acessar a página do Mercado Livre do usuário > Configurações > Preferências de venda > Código de autorização.
  • Saiba mais sobre Quando usar o código de autorização em minhas coletas do Mercado Livre ou Envíos Flex? Para receber notificações quando transferências de pacotes ocorrerem entre transportadoras e quando forem escaneados pela primeira vez, você pode se inscrever na notificação de flex handshakes.