Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 26/08/2024

Envío de datos fiscales

Importante:
Esta funcionalidad está disponible solo en Argentina.

Para la facturación automática de los ítems por Mercado Libre, primero el vendedor debe enviar los datos fiscales de los productos.


Enviar datos fiscales

Primero, debes crear las configuraciones fiscales antes de hacer la vinculación con un ítem.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "mutation CreateFiscalInformationMLA($input: CreateFiscalInformationMLAInput!) { createFiscalInformationMLA(input: $input) { sku upc ncm iva impuestoInterno description measureUnit origin customsClearanceId additionalFiscalInfo } }",
      "variables": {
        "input": {
          "sku": "string",
          "upc": "string",
          "ncm": "string",
          "iva": "string",
          "impuestoInterno": 0.0,
          "description": "string",
          "measureUnit": "string",
          "origin": "string",
          "customsClearanceId": "string",
          "additionalFiscalInfo": "string"
        }
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "mutation CreateFiscalInformationMLA($input: CreateFiscalInformationMLAInput!) { createFiscalInformationMLA(input: $input) { sku upc ncm iva impuestoInterno description measureUnit origin customsClearanceId additionalFiscalInfo } }",
      "variables": {
        "input": {
          "sku": "sku12343",
          "upc": "11111",
          "ncm": "111111",
          "iva": "21",
          "impuestoInterno": 0.0,
          "description": "producto de prueba",
          "measureUnit": "UN",
          "origin": "IMPORTED || NATIONAL",
          "customsClearanceId": "0500001234562023001",
          "additionalFiscalInfo": "Instrucciones adicionales sobre productos importados. Este campo es opcional."
        }
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Respuesta:

{
    "data": {
        "createFiscalInformationMLA": {
            "sku": "sku12343",
            "upc": "14111601",
            "ncm": "11111111",
            "iva": "21",
            "impuestoInterno": 0,
            "description": "producto de prueba",
            "measureUnit": "H87",
            "origin": "IMPORTED || NATIONAL",
         "customsClearanceId": "0500001234562023001",
         "additionalFiscalInfo": "Instrucciones adicionales sobre productos importados. Este campo es opcional."
        }
    }
 }

Configurar datos fiscales por producto

Después de informar los datos fiscales, vincula el ítem a través del SKU:

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "mutation CreateFiscalInformationLinkToItem($input: CreateFiscalInformationLinkToItemInput!) { createFiscalInformationLinkToItem(input: $input) { itemId variationId components { sku quantity percentageShare } } }",
      "variables": {
        "input": {
          "itemId": "string",
          "variationId": "string",
          "components": {
            "sku": "string",
            "quantity": 1,
            "percentageShare": 100.0
          }
        }
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "mutation CreateFiscalInformationLinkToItem($input: CreateFiscalInformationLinkToItemInput!) { createFiscalInformationLinkToItem(input: $input) { itemId components { sku quantity percentageShare } } }",
      "variables": {
        "input": {
          "itemId": "MLA1323056751",
          "components": {
            "sku": "SKU1234",
            "quantity": 1,
            "percentageShare": 100.0
          }
        }
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Respuesta:

{
    "data": {
        "createFiscalInformationLinkToItem": {
            "itemId": "MLA1323056751",
            "variationId": null,
            "type": "SINGLE",
            "components": [
                {
                    "sku": "SKU1234",
                    "quantity": 1,
                    "percentageShare": 100
                }
            ]
        }
    }
 }

Cuando el ítem sea único, el campo variationId será null.


Consultar datos fiscales por SKU

Consulta los datos fiscales utilizando el SKU:


Llamada:

ccurl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "query ($sku: String!) { getFiscalInformationBySku (sku:$sku) { ...on FiscalInformationMLA { sku ncm iva upc impuestoInterno description measureUnit origin customsClearanceId additionalFiscalInfo } } }",
      "variables": {
        "sku": "string"
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "query ($sku: String!) { getFiscalInformationBySku (sku:$sku) { ...on FiscalInformationMLA { sku ncm iva upc impuestoInterno description measureUnit origin customsClearanceId additionalFiscalInfo } } }",
      "variables": {
        "sku": "SKU1234"
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Respuesta:

{
    "data": {
        "getFiscalInformationBySku": {
            "sku": "SKU1234",
            "ncm": "14111601",
            "iva": "0",
            "upc": "11111111",
            "impuestoInterno": 0,
            "description": "producto de prueba",
            "measureUnit": "UN",
            "origin": "IMPORTED",
         "customsClearanceId": "0500001234562023001",
         "additinalFiscalInfo": "Instrucciones adicionales sobre productos importados. Este campo es opcional."
        }
    }
 }

Consultar datos fiscales por item

También puedes buscar las infos vinculadas a una publicación en Mercado Libre:

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "query ($itemId: String!, $variationId: String, $allVariations: Boolean) { getFiscalInformationsByItem (itemId:$itemId, variationId: $variationId, allVariations: $allVariations) { itemId variationId type components { sku quantity percentageShare fiscalInformation { ...on FiscalInformationMLA { ncm upc iva impuestoInterno description measureUnit origin customsClearanceId additionalFiscalInfo } } } } }",
      "variables": {
        "itemId": "string",
        "variationId": "string",
        "allVariations": false
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "query ($itemId: String!, $variationId: String, $allVariations: Boolean) { getFiscalInformationsByItem (itemId:$itemId, variationId: $variationId, allVariations: $allVariations) { itemId variationId type components { sku quantity percentageShare fiscalInformation { ...on FiscalInformationMLA { ncm upc iva impuestoInterno description measureUnit origin customsClearanceId additionalFiscalInfo } } } } }",
      "variables": {
        "itemId": "MLA1323056751",
        "variationId": "string",
        "allVariations": false
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Respuesta:

{
    "data": {
        "getFiscalInformationsByItem": [
            {
                "itemId": "MLA1323056751",
                "variationId": null,
                "type": "SINGLE",
                "components": [
                    {
                        "sku": "SKU1234",
                        "quantity": 1,
                        "percentageShare": 100,
                        "fiscalInformation": {
                            "ncm": "14111601",
                            "upc": "11111111",
                            "iva": "0",
                            "impuestoInterno": 0,
                            "description": "producto de prueba",
                            "measureUnit": "UN",
                            "origin": "IMPORTED",
                            "customsClearanceId": "0500001234562023001",
                            "additionalFiscalInfo": "Instrucciones adicionales sobre productos importados. Este campo es opcional."
                        }
                    }
                ]
            }
        ]
    }
 }

Estas son las posibles formas de hacer la búsqueda:

  • itemId: cuando la publicación no tiene variación.
  • itemId + variationId: cuando la publicación tiene variación, para obtener los datos sólo de las variaciones solicitadas.
  • itemId + allVariations: cuando la publicación tiene variación, para obtener los datos de todas las variaciones de esta publicación.

Actualizar datos fiscales

El recurso permite la actualización completa o parcial de los datos fiscales de una publicación:


Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "mutation ($where: UpdateFiscalInformationMLAWhere! $input: UpdateFiscalInformationMLAInput!) { updateFiscalInformationMLA (where: $where, input: $input) { sku ncm upc iva impuestoInterno description measureUnit origin customsClearanceId additionalFiscalInfo } }",
      "variables": {
        "where": {
          "sku": "string"
        },
        "input": {
          "ncm": "string",
          "upc": "string",
          "iva": "string",
          "impuestoInterno": 0,
          "measureUnit": "string",
          "description": "string",
          "origin": "string",
          "customsClearanceId": "string",
          "additionalFiscalInfo": "string"
        }
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {
      "query": "mutation ($where: UpdateFiscalInformationMLAWhere! $input: UpdateFiscalInformationMLAInput!) { updateFiscalInformationMLA (where: $where, input: $input) { sku ncm upc iva impuestoInterno description measureUnit origin customsClearanceId additionalFiscalInfo } }",
      "variables": {
        "where": {
          "sku": "SKU1234"
        },
        "input": {
          "ncm": "14111601",
          "upc": "11111111",
          "iva": "16",
          "impuestoInterno": 0,
          "measureUnit": "H87",
          "description": "producto de prueba",
          "origin": "IMPORTED",
          "customsClearanceId": "123456789",
          "additionalFiscalInfo": ""
        }
      }
    }
    https://api.mercadolibre.com/fiscal_information/graphql

Respuesta:

{
    "data": {
        "updateFiscalInformationMLM": {
            "sku": "SKU1234",
            "ncm": "14111601",
            "upc": "11111111",
            "iva": "16",
            "impuestoInterno": 0,
            "description": "producto de prueba",
            "measureUnit": "H87",
            "origin": "IMPORTED",
            "customsClearanceId": "123456789",
            "additionalFiscalInfo": "Updating"
        }
    }
 }

Para actualizar parcialmente los datos fiscales, envía solamente los campos necesarios en las variables después del input.


Consultar si una publicación puede ser facturada

Este recurso permite identificar si una determinada publicación tiene todos los datos necesarios para que nuestro facturador pueda emitir la nota de venta. Puede buscar por publicación o por variaciones:


Consulta por publicación:

Llamada:

curl --location --request GET 'https://api.mercadolibre.com/can_invoice/items/$ITEM_ID \
    --header 'Authorization: Bearer $ACCESS_TOKEN'

Ejemplo:

curl --location --request GET 'https://api.mercadolibre.com/can_invoice/items/MLA1984512046 \
    --header 'Authorization: Bearer $ACCESS_TOKEN'

Respuesta:

{
    "item_id": "MLA1984512046",
    "seller_id": "809726122",
    "variation_id": "",
    "status": true
 }
Nota:
Si busca una publicación con variaciones, sólo tendrá el status = true cuando todas las variaciones sean adecuadas. De lo contrario, debe identificar qué variación no tiene datos fiscales o tiene datos incorrectos y cambiarla.

Consulta por variación:

Llamada:

curl --location --request GET 'https://api.mercadolibre.com/can_invoice/items/$ITEM_ID/variations/$VARIATION_ID' \
    --header 'Authorization: Bearer $ACCESS_TOKEN'

Ejemplo:

curl --location --request GET 'https://api.mercadolibre.com/can_invoice/items/MLA1398143045/variations/$VARIATION_ID' \
    --header 'Authorization: Bearer $ACCESS_TOKEN'

Respuesta:

{
    "item_id": "MLA1984512046",
    "seller_id": "809726122",
    "variation_id": "94754627308",
    "status": true
 }

El campo de estado indica si el artículo está listo para ser facturado.