Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação

Você pode usar esta documentação para as seguintes unidades de negócio:

Última atualização em 01/11/2023

Dados para emissão de Nota Fiscal

Importante:
O recurso billing_info não é necessário em México.

​ ​

Para realizar o faturamento de uma venda, são necessários os dados do comprador que estão disponíveis através do recurso Orders, mas especificamente /orders/order_id/billing_info.

​ ​
Nota:
Os vendedores do Brasil podem criar cupons de desconto para vendas diretas e/ou de carrinho dentro do canal de Marketplace, saiba como faturar essas vendas.

Consultar os dados para faturamento

Para obter as informações do comprador (endereço, documento) para emissão da nota fiscal. Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID/billing_info

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/1691789796/billing_info

As orders do Mercado Libre Argentina e Brasil retornam dados de faturamento nas seguintes condições:

  • Produtos com Fullfillment ou CrossDocking
  • Produtos de Lojas Oficiais, Mercado Lideres.
  • Produtos com Global Selling.
  • Compras com Garex.

Resposta (os exemplos são de pessoa física e pessoa jurídica) MLB - Pessoa Física
Order Id: 1691812163
User id: 316452397

{
  "billing_info": {
    "additional_info": [
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STREET_NUMBER",
        "value": "3571"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "LAST_NAME",
        "value": "Gomez Blanco"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_NUMBER",
        "value": "32659430"
      },
      {
        "type": "DOC_TYPE",
        "value": "DNI"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "FIRST_NAME",
        "value": "María Lupita"
      },
      {
        "type": "NEIGHBORHOOD",
        "value": "Divino"
      }
    ],
    "doc_number": "32659430",
    "doc_type": "DNI"
  }
}


MLB - Pessoa Jurídica

Order Id: 1691816147
User id: 316452397

{
  "billing_info": {
    "additional_info": [
      {
        "type": "DOC_NUMBER",
        "value": "30703088534"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STATE_REGISTRATION",
        "value": "30703088534"
      },
      {
        "type": "TAXPAYER_TYPE_ID",
        "value": "IVA Responsable Inscripto"
      },
      {
        "type": "BUSINESS_NAME",
        "value": "Mercado Libre S.R.L"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "STREET_NUMBER",
        "value": "SN"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_TYPE",
        "value": "CUIT"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
      {
        "type": "NEIGHBORHOOD",
        "value": "Divino"
      }
 ],
    "doc_number": "30703088534",
    "doc_type": "CUIT"
  }
}
​


Tipos e valores para additional_info

Esses são os tipos e valores (type/value) possível para additional_info.

Pessoa física

  • first_name: nome do comprados
  • last_name: sobrenome do comprador
  • doc_type: tipo do documento
  • doc_number: numero do documento
  • zip_code: código postal do comprador
  • street_name: endereço do comprador
  • street_number: numero endereço do comprador

Pode ser "SN" para casos de rua sem numero

  • comment: comentário extra sobre endereço do comprador
  • state_name: estado do comprador
  • city_name: cidade do comprador
  • secondary_doc_type : tipo do documento adicional (solo para MLA)
  • secondary_doc_number: numero de documento adicional (solo para MLA)
​ ​

Pessoa jurídica

  • business_name: nome da entidade jurídica que compra
  • taxpayer_type_id: posição da entidade jurídica
  • ​ ​

    Para MLA:
    -Monotributo
    -IVA Responsable Inscripto
    -IVA Exento

    ​ Para MLB:
    -Contribuinte
    -Não contribuinte

  • state_registration
  • doc_type: tipo do documento
  • doc_number: numero do documento
  • zip_code: código postal do comprador
  • street_name: nome endereço do comprador
  • street_number: número endereço do comprador

  • Pode ser "SN" para casos de rua sem número


  • comment: comentário extra sobre endereço do comprador
  • state_name: estado do comprador
  • city_name: cidade do comprador

  • DOC_TYPE's

    Argentina (MLA): DNI, CUIT.

    Brasil (MLB): CPF, CNPJ.

    Chile (MLC): RUT.

    Colombia (MCO): CC, CE, NIT.

    Venezuela (MLV): CI, RIF, Pasaporte.

    Uruguay (MLU): CI, RUT.

    Perú (MPE): DNI, CE.


    Nota:
    Recomendamos que revise os detalhes de todos os descontos aplicados em uma venda. É possível obter estes detalhes com o recurso /discount.