Conteúdos

→Enviar inscrições estaduais →Cadastro Inscrição Estadual por Estado →Criar nova Inscrição estadual para um determinado Estado →Atualizar nova Inscrição Estadual para um determinado Estado →Atualizar/criar Inscrição Estadual em Batch →Apagar Inscrição Estadual →Consultar Inscrição Estadual por CNPJ →Consultar Inscrição Estadual por CNPJ e Estado

Enviar inscrições estaduais

O cadastro das inscrições estaduais é opcional pois destina-se somente ao sellers que possuem diferentes inscrições estaduais. Esta funcionalidade permite gerenciar as suas inscrições estaduais para cada Estado.

Cadastro

Inscrição Estadual por Estado

Campo Tipo Descrição Valores possíveis
state string Informa a UF do Estado de determinada Inscrição Estadual "AC", "AL", "AM", "AP", "BA", "CE", "DF", "ES", "GO", "MA", "MT", "MS", "MG", "PA", "PB", "PR", "PE", "PI", "RJ", "RN", "RO", "RS", "RR", "SC", "SE", "SP", "TO"
gnre_enable boolean Informa se devemos gerar a GNRE sim ou não. Por exemplo, caso for cadastrado um registro de Inscrição Estadual para o estado “MG” e o valor deste campo for “gnre_enable=true” iremos gerar a gnre para vendas para esse estado, mesmo existindo IE cadastrada. true false (default)
state_registry string Valor da Inscrição Estadual
cnpj string Valor do CNPJ
origin boolean Informa se a IE em questão é de origem ou destino. true false (default)


Criar nova inscrição estadual para um determinado Estado

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "content-type:application/json" "http://api.mercadolibre.com/users/$USER_ID/invoices/state_registry/$CNPJ/$STATE" -d '
{
    "state_registry": "1262819934920",   // INSCRIÇÃO ESTADUAL
    "gnre_enable": true
} 

Resposta:

Status code: 201 - Created

{
    "seller_id": 359450559,
    "cnpj": "52640544000111",
    "state": "mg",
    "state_registry": "1262819934920",
    "gnre_enable": true,
    "origin": false
 }

Atualizar nova inscrição estadual para um determinado Estado

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "content-type:application/json" "http://api.mercadolibre.com/users/$USER_ID/invoices/state_registry/$CNPJ/$STATE" -d '
{
    "state_registry": "1713072179209",
    "gnre_enable": false
}

Resposta:

Status code: 200 - OK

{
    "seller_id": 359450559,
    "cnpj": "52640544000111",
    "state": "mg",
    "state_registry": "1713072179209",
    "gnre_enable": false,
    "origin": false
}


Atualizar/criar Inscrição Estadual em Batch

Neste endpoint poderão ser passadas várias inscrições estaduais por parâmetro e o sistema irá identificar se é necessário criar ou atualizar determinado registro.

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "content-type:application/json" http://api.mercadolibre.com/users/$USER_ID/invoices/state_registry/$CNPJ/batch -d '
[
	{
	    "state": "sp",
	    "state_registry": "097817832671",
	    "gnre_enable": false
	},
	{
	    "state": "rj",
	    "state_registry": "700219151993",
	    "gnre_enable": true
	}
]

Resposta caso todos os registros foram processados com sucesso

Status code: 200 - OK

Resposta caso algum dos registros não tiver sido processado com sucesso

Status code: 200 - OK

Body

[
    {
        "message": "Inscrição Estadual deve ser preenchida",
        "error_code": "10211",
        "state_registry": {
            "seller_id": 359450559,
            "cnpj": "52640544000111",
            "state": "rj",
            "state_registry": "",
            "gnre_enable": true,
            "origin": false
        }
    }
]

Apagar Inscrição Estadual

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN'  http://api.mercadolibre.com/users/$USER_ID/invoices/state_registry/$CNPJ/$STATE

Resposta:

Status 200 - OK


Consultar Inscrição Estadual por CNPJ

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/users/$USER_ID/invoices/state_registry/$CNPJ

Resposta:

Status 200 - OK

[
    {
        "seller_id": 123,
        "cnpj": "43394618000196",
        "state": "rj",
        "state_registry": "700219151993",
        "gnre_enable": true,
         "origin": false
    },
    {
        "seller_id": 123,
        "cnpj": "43394618000196",
        "state": "sp",
        "state_registry": "097817832671",
        "gnre_enable": false,
         "origin": false
    }
]

Consultar Inscrição Estadual por CNPJ e Estado

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/users/$USER_ID/invoices/state_registry/$CNPJ/$STATE

Resposta:

Status 200 - OK

Body:

{
    "seller_id": 359450559,
    "cnpj": "52640544000111",
    "state": "rj",
    "state_registry": "700219151993",
    "gnre_enable": true,
    "origin": false
}

Seguinte: Notificações de invoices.

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