Envio dos dados fiscais

O envio dos dados fiscais é feito assim:

curl -X POST -H"content-type:application/json" http://api.mercadolibre.com/items/fiscal_information?access_token=$ACCESS_TOKEN -d '

Json para configurar um produto:

{
	"sku": "QW123",
	"title": "Iphone 7",
	"type": "single",
	"measurement_unit": "UN",
	"cost": 3000.00,
	"tax_information": {
		"ncm": "39263000",
		"origin_type": "reseller",
		"origin_detail": "2",
		"tax_rule_id": "6",  //ID do grupo de regras, apenas para Regime Normal, para Simples Nacional deixar em branco
		"csosn": "500",
		"cest": "0100500",
		"fci": "A3F1D0A2-16CB-4DF1-816E-F062A515035B",
		"ex_tipi": "01",
		"ean": "4242002824628"
	}
}
Notas:
- O campo csosn deve ser enviado somente para sellers Regime Simples Nacional.
- O campo measurement_unit é opcional
- O campo ex_tipi é opcional
- O campo fci é opcional, mas pode ser preenchido somente quando o campo origin_detail for 3, 5 ou 8

Resposta

Status code: 201- Created

Body:

{
    "seller_id": "359450559",
    "sku": "QW123",
    "title": "Iphone 7",
    "type": "single",
     "measurement_unit": "UN",
    "tax_information": {
        "ncm": "39263000",
        "origin_type": "reseller",
        "origin_detail": "2",
        "csosn": "500",
        "cest": "0100500",
         "fci": "A3F1D0A2-16CB-4DF1-816E-F062A515035B",
         "ex_tipi": "01",
        "ean": "4242002824628",
        "tax_rule_id": 6,
        "empty": false
    },
    "cost": 3000,
    "register_type": "final"
}

400 - Bad Request


Acontece quando algum dado obrigatório não foi preenchido ou quando algum dado está inválido.


Body:

{
    "message": "Many errors. 1 embedded errors, see errorlist property for details",
    "error_code": "json_validation_error",
    "fields": [
        {
            "field": "tax_information.ncm",
            "message": "tax_information.ncm is required.",
            "error_code": "10027"
        }
    ]
}

 

Atualizaçāo os dados fiscais

Os dados enviados podem ser atualizados assim:

curl -X PUT -H"content-type:application/json" "http://api.mercadolibre.com/items/fiscal_information/$SKU_ID?access_token=$ACCESS_TOKEN" -d '
{
    "title": "Iphone X",
    "type": "single",
     "measurement_unit": "UN",
    "cost":  5000.00,
    "tax_information": {
        "ncm": "39263000",
        "origin_type": "reseller",
        "origin_detail": "2",
        "tax_rule_id": "7",
        "csosn": "500",
        "cest": "0100500",
         "fci": "A3F1D0A2-16CB-4DF1-816E-F062A515035B",
         "ex_tipi": "01",
        "ean": "4242002824628"
    }
}

 

Resposta
Status code: 200 - OK
Body:

{
    "seller_id": "359450559",
    "sku": "QW123",
    "title": "Iphone X",
    "type": "single",
    "measurement_unit": "UN",
    "tax_information": {
        "ncm": "39263000",
        "origin_type": "reseller",
        "origin_detail": "2",
        "csosn": "500",
        "cest": "0100500",
        "fci": "A3F1D0A2-16CB-4DF1-816E-F062A515035B",
        "ex_tipi": "01",
        "ean": "4242002824628",
        "tax_rule_id": 7,
        "empty": false
    },
    "cost": 5000,
    "register_type": "final"
}

Status code: 400 - Bad Request


Acontece quando algum dado obrigatório não foi preenchido ou quando algum dado está inválido.


Body:

{
    "message": "Many errors. 1 embedded errors, see errorlist property for details",
    "error_code": "json_validation_error",
    "fields": [
        {
            "field": "tax_information.fci",
            "message": "A valid FCI is required in order to create this SKU",
            "error_code": "10294"
        }
    ]
}

Atualização parcial dos dados fiscais

Os dados enviados podem ser atualizados assim:

curl -X PATCH -H"content-type:application/json" "http://api.mercadolibre.com/items/fiscal_information/{SKU_ID}?access_token=$ACCESS_TOKEN" -d '
{
        "tax_rule_id": "4",
}

Status code: 200 - OK

Body:

{
    "seller_id": "359450559",
    "sku": "QW123",
    "title": "Iphone X",
    "type": "single",
    "measurement_unit": "UN",
    "tax_information": {
        "ncm": "39263000",
        "origin_type": "reseller",
        "origin_detail": "2",
        "csosn": "500",
        "cest": "0100500",
        "fci": "A3F1D0A2-16CB-4DF1-816E-F062A515035B",
        "ex_tipi": "01",
        "ean": "4242002824628",
        "tax_rule_id": 4,
        "empty": false
    },
    "cost": 5000,
    "register_type": "final"
}

Status code: 400 - Bad Request


Acontece quando algum dado está inválido.

Body:

{
    "message": "The tax_rule_id field must be numeric",
    "error_code": "400 BAD_REQUEST"
}
Nota:
A atualização parcial está disponível apenas para os campos: cost, measurement_unit, fci, ex_tipi e tax_rule_id

Consulta dos dados fiscais cadastrados por sku

curl -X GET http://api.mercadolibre.com/items/fiscal_information/$SKU?access_token=$ACCESS_TOKEN
{
    "seller_id": "359450559",
    "sku": "QW123",
    "title": "Iphone X",
    "type": "single",
    "measurement_unit": "UN",
    "tax_information": {
        "ncm": "39263000",
        "origin_type": "reseller",
        "origin_detail": "2",
        "csosn": "500",
        "cest": "0100500",
        "fci": "A3F1D0A2-16CB-4DF1-816E-F062A515035B",
        "ex_tipi": "01",
        "ean": "4242002824628",
        "tax_rule_id": 7,
        "empty": false
    },
    "cost": 5000,
    "register_type": "final"
}

Status code: 404 - NOT FOUND


Acontece quando o sku informado não existe.

Body:

{
    "message": "Sku not found by sku: QW124 and caller.id: 359450559",
    "error_code": "404 NOT_FOUND"
}


Consulta dos dados fiscais cadastrados por item

curl -X GET http://api.mercadolibre.com/items/$ITEM_ID/fiscal_information/detail?access_token=$ACCESS_TOKEN
{
	"item_id": "MLB123456",
	"seller_id": "SELLER_ID",
	"variations": [{
		"id": "31734796796",
		"sku": {
			"seller_id": "SELLER_ID",
			"sku": "KIT-QW123-QW456",
			"title": "Kit Iphone 7 + Capinha",
			"type": "bundle",
			"bundle": [{
					"sku": "QW123",
					"title": "Iphone 7",
					"quantity": 1,
					"percentage_share": 90,
					"measurement_unit": "UN",
					"cost": 2990.00,
					"tax_information": {
						"ncm": "39263000",
						"origin_type": "reseller",
						"origin_detail": "2",
						"tax_rule_id": "1",
						"csosn": "500",
						"cest": "0100500",
						"fci": "A3F1D0A2-16CB-4DF1-816E-F062A515035B",
						"ex_tipi": "01",
						"ean": "4242002824628",
						"empty": false
					}
				},
				{
					"sku": "QW456",
					"quantity": 1,
					"percentage_share": 10,
					"cost": 10.00,
					"tax_information": {
						"ncm": "39263010",
						"origin_type": "reseller",
						"origin_detail": "2",
						"tax_rule_id": "1",
						"csosn": "500",
						"cest": "0100509",
						"ean": "2242002824728",
						"empty": false
					}
				}
			],
			"register_type": "final"
		}
	}]
}

Status code: 404 - NOT FOUND


Acontece quando o item informado não existe.


Body:

{
    "message": "Item not found.",
    "error_code": "10095"
}



Configuraçāo de kit 

Um kit é configurado com a finalidade do seller ter dois produtos no mesmo anúncio e precisa informar quanto é a porcentagem de cada produto deste kit que sairá na nota.

curl -X POST -H"content-type:application/json" "http://api.mercadolibre.com/items/fiscal_information?access_token=$ACCESS_TOKEN" -d '
{
    "sku": "KIT-QW123-QW456",
    "title": "Kit Iphone 7 + Capinha",
    "type": "bundle",
    "register_type": "final",
    "bundle": [
        {
            "sku": "QW123",
            "quantity": 1,
            "percentage_share": 90
        },
        {
            "sku": "QW456",
            "quantity": 1,
            "percentage_share": 10
        }
    ]
}


Resposta
Status code: 201 - Created
Body:

{
    "seller_id": "359450559",
    "sku": "KIT-QW123-QW456",
    "title": "Kit Iphone 7 + Capinha",
    "type": "bundle",
    "bundle": [
        {
            "sku": "QW123",
            "quantity": 1,
            "percentage_share": 90
        },
        {
            "sku": "QW456",
            "quantity": 1,
            "percentage_share": 10
        }
    ],
    "register_type": "final"
}

Status code: 400 - BAD REQUEST


Acontece quando um sku informado não existe ou quando tem um sku repetido no kit


Body:

{
    "message": "Many errors. 3 embedded errors, see errorlist property for details",
    "error_code": "json_validation_error",
    "fields": [
        {
            "field": "bundle",
            "message": "More than one element with sku QW124 found.",
            "error_code": "10084"
        },
        {
            "field": "bundle",
            "message": "Sku QW124 not found.",
            "error_code": "10086"
        },
        {
            "field": "bundle",
            "message": "Sku QW124 not found.",
            "error_code": "10086"
        }
    ]
}


Vinculando um sku (produto ou kit) a um anúncio:

curl -X POST -H"content-type:application/json" "http://api.mercadolibre.com/items/fiscal_information/items?access_token=$ACCESS_TOKEN"
{
    "sku": "QW123",
    "item_id": "MLB1177001951",
    "variation_id": ""
}


Resposta
Status code: 201 - Created
Body:

{
    "sku": "QW123",
    "item_id": "MLB1177001951",
    "variation_id": "",
    "create_date": "2019-02-11T09:33:16.506",
    "update_date": "2019-02-11T09:33:16.507",
    "status": "active"
}

Status code: 404 - NOT FOUND


Acontece quando o item informado não existe ou não pertence ao seller informado


Body:


{
    "message": "Item not found or does not belong to this seller.",
    "error_code": "10095"
}

Status code: 400 - BAD REQUEST

Acontece quando o sku informado não existe


Body:


{
    "message": "Sku not found by sku: QW124 and caller.id: 493344569",
    "error_code": "10086"
}
Notas:
- Vale ressaltar onde, uma vez que estes dados são cadastrados, mesmo se um PUT no atributo SELLER_SKU a nível item for executado, sendo com outro valor ou deixando em branco, este sku com os dados fiscais, permanecerá vinculado ao item.
- O campo variation_id, pode ser usado caso o SKU for a nível variação, se o item não tiver variação o campo pode ser enviado em branco.

Seguinte: Envío de inscrições estaduais.

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