Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação do

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

Última atualização em 09/09/2024

Dados para emissão de Nota Fiscal

Importante:
  • Para obter a resposta com a nova versão, envie o header 'x-version: 2'.
  • Informamos que a V2 do recurso já está disponível para todos os sites, com exceção de Venezuela.

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 para emissão da nota fiscal. Chamada:

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

Exemplo:

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

Resposta com os exemplos de pessoa física e pessoa jurídica.

MLB - Pessoa Física

{
  "site_id": "MLB",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "María Lupita",
      "last_name": "Gomez Blanco",
      "identification": {
        "type": "CPF",
        "number": "32659430" 
      },
      "address": {
        "street_name": "Nicolau de Marcos",
        "street_number": "05",
        "city_name": "Bom Jardim",
        "comment": "7b",
        "neighborhood": "Jardim Ornelas",
        "state": {
          "name": "Rio de Janeiro"
        },
        "zip_code": "28660000",
        "country_id": "BR"
      },
      "attributes": {
          "is_normalized": true,
          "cust_type": "CO"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }}

MLB - Pessoa Jurídica

{
  "site_id": "MLB",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Apple Brasil",
   "identification": {
        "type": "CNPJ",
        "number": "326594309119203" 
      },
      "taxes": {
        "inscriptions": 
         {
            "state_registration": "30703088534",
         }
        , 
        "taxpayer_type": {
          "description": "Contribuinte" 
        }
      },
      "address": {
        "street_name": "Nicolau de Marcos",
        "street_number": "05",
        "city_name": "Bom Jardim",
        "comment": "7b",
        "neighborhood": "Jardim Ornelas",
        "state": {
          "name": "Rio de Janeiro"
        },
        "zip_code": "28660000",
        "country_id": "BR"
      },
      "attributes": {
          "is_normalized": true,
          "cust_type": "BU"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }}

MLA - Pessoa Física

{
    "site_id":"MLA",
    "buyer":{
        "cust_id": "123123123"
       "billing_info":{
          "name":"Juan Soares",
          "last_name":"Sanchez",
          "identification":{
             "type":"DNI" / "CUIL",
             "number":"307722738"
          },
          "taxes": {
            "taxpayer_type": {
                "id": "01",
                "description": "Consumidor Final"
            }
          },
          "address":{
             "street_name":"Aysen",
             "street_number":"30",
             "city_name":"Buenos Aires",
             "state":{
                "code": "01",
                "name": "Buenos Aires"
            },
             "zip_code":"5000",
             "country_id":"AR"
          },
          "attributes": {
            "vat_discriminated_billing": "true",
            "doc_type_number": "123123123",
            "is_normalized": true,
            "cust_type": "CO"
          }
       }
    },
    "seller":{
        "cust_id": 0,
    }

MLA - Pessoa Jurídica

{
    "site_id":"MLA",
    "buyer":{
        "cust_id": "123123123",
       "billing_info":{
          "name":"Apple Argentina"
          "identification":{
             "type":"CUIT",
             "number":"307722738"
          },
          "taxes": {
            "taxpayer_type": {
                "description": "IVA Responsable Inscripto"
            }
          },
          "address":{
             "street_name":"Aysen",
             "street_number":"30",
             "city_name":"Buenos Aires",
             "state":{
                "code": "01",
                "name": "Buenos Aires"
            },
             "zip_code":"5000",
             "country_id":"AR"
          },
          "attributes": {
            "vat_discriminated_billing": "true",
            "doc_type_number": "123123123",
            "is_normalized": true,
            "cust_type": "BU"
          }
       }
    },
    "seller":{
        "cust_id": 0,
    }

MLM - Pessoa Física

{
  "site_id": "MLM",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Juan Soraes",
   "last_name": "Sanchez"	
      "identification": {
        "type": "RFC",
        "number": "CUPU800825569"
      },
      "taxes": {
        "contributor": "PERSONA FÍSICA",
        "taxpayer_type": {
          "id": "606",
          "description": "Arrendamiento"
        },
        "cfdi": {
          "id": "G03",
          "description": "Gastos en general"
        }
      },
      "address": {
        "street_name": "Calle 134A #18A",
        "street_number": "05",
        "city_name": "Alvaro Obregón",
        "state": {
          "code": "DIF",
          "name": "Distrito Federal"
        },
        "zip_code": "01040",
        "country_id": "MX"
      },
      "attributes": {
        "vat_discriminated_billing": "true",
        "birth_date": "2000/02/03",
        "is_normalized": true,
        "customer_type": "CO"
      }
    }
  },
  "seller": {
    "cust_id": 34345454  }}

MLM - Pessoa Jurídica

{
  "site_id": "MLM",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "SALVADO HNOS S A",
      "identification": {
        "type": "RFC",
        "number": "CUPU800825569"
      },
      "taxes": {
        "contributor": "PERSONA MORAL",
        "taxpayer_type": {
          "id": "606",
          "description": "Arrendamiento"
        },
        "cfdi": {
          "id": "G03",
          "description": "Gastos en general"
        }
      },
      "address": {
        "street_name": "Calle 134A #18A",
        "street_number": "05",
        "city_name": "Alvaro Obregón",
        "state": {
          "code": "DIF",
          "name": "Distrito Federal"
        },
        "zip_code": "01040",
        "country_id": "MX"
      },
      "attributes": {
        "vat_discriminated_billing": "true",
        "birth_date": "2000/02/03",
        "is_normalized": true,
        "customer_type": "BU"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
 }
}

Nota:
  • Quando os dados de faturação do comprador indicarem o RFC genérico XAXX010101000, isso significa que o comprador não solicitou uma fatura nominal. Nesse caso, o vendedor terá a liberdade de decidir se vai emitir uma fatura genérica ou uma fatura global.

MLC - Pessoa Física

{
    "site_id": "MLC",
    "buyer": {
      "cust_id": 234343545,
      "billing_info": {
        "name": "Tamara nicolt",
        "last_name": "larenas reyes",
        "identification": {
          "type": "RUT",
          "number": "159321126"
        },
     "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "56",
          "city_name": "Maipú",
          "comment": "73",
          "neighborhood": "Maipú",
          "state": {
            "name": "RM (Metropolitana)"
          },
          "country_id": "CL"
        },
        "attributes": {
          "is_normalized": true,
           "cust_type": "CO"
       }
      }
    },
    "seller": {
      "cust_id": 34345454,
    }
  }

MLC - Pessoa Jurídica

{
    "site_id": "MLC",
    "buyer": {
      "cust_id": 234343545,
      "billing_info": {
        "name": "Apple",
        "identification": {
          "type": "RUT",
          "number": "159321126"
        },
        "taxes": {
           "economic_activity": "Vta.y arrdo artcls Electrónico",
        },
        "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "56",
          "city_name": "Maipú",
          "comment": "73",
          "neighborhood": "Maipú",
          "state": {
            "name": "RM (Metropolitana)"
          },
          "country_id": "CL"
        },
        "attributes": {
          "is_normalized": true,
      "cust_type": "BU" 
       }
      }
    },
    "seller": {
      "cust_id": 34345454,
    }
  }

MCO - Pessoa Física

{
  "site_id": "MCO",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Adrian",
      "last_name": "Garces",
      "identification": {
        "type": "CC",
        "number": "73160000"
      },
     "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "#10-11",
          "city_name": "La Candelaria",
          "comment": "73",
          "neighborhood": "Candelaria",
          "state": {
            "name": "RM (Metropolitana)",
	     "code": "CO-DC"
          },
          "country_id": "CO"
        },
  },
  "seller": {
    "cust_id": 34345454,
  }
}


MCO - Pessoa Jurídica

{
  "site_id": "MCO",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Apple",
      "identification": {
        "type": "CC",
        "number": "73160000"
      },
      "address": {
          "street_name": "Pasaje Beethoven",
          "street_number": "#10-11",
          "city_name": "La Candelaria",
          "comment": "73",
          "neighborhood": "Candelaria",
          "state": {
            "name": "RM (Metropolitana)",
	     "code": "CO-DC"
          },
          "country_id": "CO"
        },
      "attributes": {
        "is_normalized": true
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }

MEC - Pessoa Física

{
  "site_id": "MEC",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Adrian",
      "last_name": "Garces",
      "identification": {
        "type": "RUC" / "CI",
        "number": "1711168979001"
      },
      "address": {
        "country_id": "EC"
      },
      "attributes": {
        "is_normalized": true
    "email":"test_user_937841642@testuser.com"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }
}

MEC - Pessoa Jurídica

{
  "site_id": "MEC",
  "buyer": {
    "cust_id": 234343545,
    "billing_info": {
      "name": "Apple",
      "identification": {
        "type": "RUC",
        "number": "1711168979001"
      },
      "address": {
        "country_id": "EC"
      },
      "attributes": {
        "is_normalized": true
    	 "email":"test_user_937841642@testuser.com"
      }
    }
  },
  "seller": {
    "cust_id": 34345454,
  }
}

MPE - Pessoa Física e Pessoa Jurídica

{
    "buyer": {
        "cust_id": "325999999",
        "billing_info": {
            "identification": {
                "type": "DNI",
                "number": "70999999"
            },
            "attributes": {
                "normalized": "false",
                "is_vat_discriminated_billing": false,
                "is_new_billing_info": false
            }
        }
    },
    "seller": {
        "cust_id": "1469999999"
    },
    "buyer_id": 325999999,
    "seller_id": 1469999999,
    "is_order_origin": false
 }
 

MLU - Pessoa Física

{
    "buyer": {
        "cust_id": "1921961891",
        "billing_info": {
            "identification": {
                "type": "CI",
                "number": "64856596"
            },
            "attributes": {
                "normalized": "false",
                "is_vat_discriminated_billing": false,
                "is_new_billing_info": false
            }
        }
    },
    "seller": {
        "cust_id": "293733309"
    },
    "buyer_id": 1921961891,
    "seller_id": 293733309,
    "is_order_origin": false
 }
 

MLU - Pessoa Jurídica

{
    "buyer": {
        "cust_id": "1934756972",
        "billing_info": {
            "identification": {
                "type": "RUT",
                "number": "215191230015"
            },
            "attributes": {
                "normalized": "false",
                "is_vat_discriminated_billing": false,
                "is_new_billing_info": false
            }
        }
    },
    "seller": {
        "cust_id": "293733309"
    },
    "buyer_id": 1934756972,
    "seller_id": 293733309,
    "is_order_origin": false
 }
 


Tipos e valores para additional_info

Estes são os tipos/valores (type/value em additional_info) possíveis para diferentes atores:

Pessoa física

  • first_name: o(s) nome(s) do comprador
  • last_name: o sobrenome do comprador
  • doc_type: o tipo de documento
  • doc_number: o número do documento
  • zip_code: o código postal do comprador
  • street_name: o nome da rua do endereço de faturamento do comprador
  • street_number: o número da rua do endereço de faturamento do comprador

Valores possíveis: qualquer string, "SN" para casos de rua sem número

  • comment: andar do endereço de faturamento do comprador
  • state_name: estado do endereço de faturamento do comprador
  • city_name: cidade do endereço de faturamento do comprador
  • secondary_doc_type: tipo de documento adicional (apenas para MLA)
  • secondary_doc_number: número de documento adicional (apenas para MLA)

Pessoa jurídica

  • business_name: nome da entidade jurídica que compra
  • taxpayer_type_id: posição da entidade jurídica em relação ao IVA
  • Para MLA:
    -Monotributo
    -IVA Responsável Inscrito
    -IVA Isento

    Para MLB:
    -Contribuinte
    -Não contribuinte

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

  • Valores possíveis: qualquer string, "SN" para casos de rua sem número


  • comment: andar do endereço de faturamento do comprador
  • state_name: estado do endereço de faturamento do comprador
  • city_name: cidade do endereço de faturamento do comprador

  • DOC_TYPE's

    Uruguai (MLU): CI, RUT.

    Peru (MPE): DNI, CE.

    Tipos e valores

    site_id : Id do site

    buyer:

    • cust_id: Id do comprador

    billing_info:

    • name: nome do comprador
    • last_name: último nome do comprador
    • identification:
      • type: tipo do documento
      • number: número do documento

    taxes:

    • Inscriptions:
      • state_registration: inscrição estadual
    • economic_activity: atividade econômica
    • contributor: tipo de contribuinte
    • taxpayer_type
      • id:
      • description: situação fiscal do buyer

    address:

    • street_name: nome da rua do comprador
    • street_number: número do endereço do comprador
    • city_name: nome da cidade do comprador
    • neighbhood: nome do bairro do comprador
    • zip_code: código postal do comprador
    • comment: comentário extra sobre endereço do comprador
    • country_id: Id do país
    • state:
      • code: código do estado
      • name: nome do estado

    attributes:

    • birth_date: data de aniversário do comprador
    • doc_type_number: número do documento
    • cust_type: tipo de pessoa (Pessoa Jurídica ou Pessoa Física)

    seller:

    • cust_id: Id do vendedor

    Os valores CO ou BU presentes no campo cust_type significam:
    - CO : Customer
    - BU : Business

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