Dados de faturamento

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 específicamente /orders/order_id/billing_info.

Conteúdos

→Consultar os dados para faturamento
→Tipos e valores para additional_info


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 https://api.mercadolibre.com/orders/$ORDER_ID/billing_info?access_token=$ACCESS_TOKEN

Exemplo:

curl -X GET https://api.mercadolibre.com/orders/1691789796/billing_info?access_token=$ACCESS_TOKEN

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

  • Produtos con Retirada em loja, 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ívels no 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: ndereç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: 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

  • 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.

    ou registre-se para receber as últimas notícias sobre nossa API