Mensagens de operação

Enviar mensagens de operação

A informação type se refere ao tipo de mensagem que pode ser encaminhado:

COMPL
A mensagem é encaminhada na nota fiscal "PDF".
Suporta a mensagem adicional personalizada $EXTERNAL_ORDER_ID.
É utilizado como tipo de mensagem padrão pelo Mercado Livre.
É o mais utilizado no sistema de integração.
Quantidade máxima de carácter suportado TAX_RULE_MESSAGE_COMPL_MAX_SIZE = "10243".

ITEM
É encaminhado apenas para um item específico.
É encaminhado apenas no XML que é enviado para a "SEFAZ".
Não é encaminhado na nota em "PDF".
Não é emitido na documentação "DANFE".
Tem pouca utilização no Mercado Livre e não é utilizado no sistema de integração.
Quantidade máxima de carácter suportado TAX_RULE_MESSAGE_ITEM_MAX_SIZE = "10242".

FISCAL
É encaminhado apenas no XML que é enviado para a "SEFAZ".
Não é encaminhado na nota em "PDF".
Não é emitido na documentação "DANFE".
Tem pouca utilização no Mercado Livre e não é utilizado no sistema de integração.
Quantidade máxima de carácter suportado TAX_RULE_MESSAGE_FISCAL_MAX_SIZE = "10244.

ADDITIONAL
A mensagem é encaminhada na nota fiscal "PDF".
É encaminhado no campo "Complemento" nota fiscal "PDF".
É adicionado junto com o CPL do código.
Não é emitido na documentação "DANFE".
Tem pouca utilização no Mercado Livre e não é utilizado no sistema de integração.

Exemplo "messages":

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "content-type:application/json" https://api.mercadolibre.com/users/$USER_ID/invoices/tax_rules/messages"

Exemplo de requisição:

{
  "user_id":359450559,
  "message":"Mensagem teste que ficará no campo de obs da NF-e",
  "type":"ITEM"
}

Exemplo de resposta:

{
    "id": 49,
    "message": "Mensagem teste que ficará no campo de obs da NF-e",
    "type": "item",
    "user_id": 359450559
}

É possível também personalizar a mensagem de operação incluindo o número do pedido. Para isso, utilize a tag $EXTERNAL_ORDER_ID no corpo da mensagem. A tag será substituída pelo número do pedido conforme exemplo abaixo:
Pedido n: $EXTERNAL_ORDER_ID", que terá como resultado: "Pedido n: 22334455"

Exemplo de requisição:

{
  "user_id":359450559,
  "message":"Mensagem teste que ficará no campo de obs da NF-e, Pedido N: $EXTERNAL_ORDER_ID",
  "type":"compl"
}

Exemplo de resposta:

{
    "id": 49,
    "message": "Mensagem teste que ficará no campo de obs da NF-e, Pedido N: 22334455",
    "type": "compl",
    "user_id": 359450559
}

Consultar mensagens

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/invoices/tax_rules/messages
{
    "paging": {
        "total": 2,
        "offset": 0,
        "limit": 50
    },
    "results": [
        {
"id": 49,
            "message": "Mensagem teste que ficará no campo de obs da NF-e",
            "type": "item",
            "user_id": 359450559
        },
        {
            "id": 50,
            "message": "Mensagem 2 teste que ficará no campo de obs da NF-e",
            "type": "item",
            "user_id": 359450559
        }
    ],
    "sort": [
        {
            "id": "id",
            "name": "ID, ASC"
        }
    ],
    "filters": [],
    "available_filters": [],
    "available_sorts": []
}

Consultar mensagens por ID

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/invoices/tax_rules/messages/$ID_MENSAGEM

Exemplo de resposta:

 {  
  "id":2,
  "user_id":20000000,
  "message":"Outra mensagem cadastrada",
  "type":"ITEM"
}

Atualizar mensagens

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "content-type:application/json"  https://api.mercadolibre.com/users/$USER_ID/invoices/tax_rules/messages/$ID_MENSAGEM -d '

Exemplo de requisição:

{
  "user_id":20000000,
  "message":"Outra mensagem cadastrada",
  "type":"ITEM"
}

Exemplo de resposta:

{  
  "id":2,
  "user_id":20000000,
  "message":"Outra mensagem cadastrada",
  "type":"ITEM"
}

Apagar mensagens

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/invoices/tax_rules/messages/$ID_MENSAGEM

Resposta:

 Http status da operação (200 para sucesso)

Seguinte: Envio dos dados fiscais.