Novo recurso “Suggestions” e melhorias nos recursos de PLP e INVOICE

3 Maio 2017

Favor analisar a documentação abaixo e, no caso das melhorias, verificar o impacto nas suas aplicações.

Qualquer ajuste necessário deverá ser feito, testado e disponibilizado até 16/06.

API Suggestions

Os dados de Imposto de Renda imputados a mão para XD (Cross Docking) gera possíveis erros humanos. Colocar dados fiscais incorretos gera inconsistências no fluxo e atrasa a entrega dos produtos. Por esta razão, a API Suggestions foi criada para minimizarmos a possibilidade de erros humanos, sugerindo aos vendedores possíveis notas fiscais para uma ordem, e, assim, reduzindo os casos de atraso devido inconsistência nos dados da NF.

Chamada:

 /orders/<$orderId>/invoice/suggestion?caller.id=

Resposta:

200
data: [
[
    "nsu": 1671982,
    "chave": 35160509627189000111550010000577001000577006,
    "xml": " xml de la nota fiscal ",
    "order_ids": [
        1103928153
    ],
    "date_created": "new Date()",
    "type": "invoice"
],
…
]

Unificação de criação e impressão de PLP

Atualmente existem dois recursos relacionados a PLP:

URL para CRIAÇÃO:

 “/shipment_pickup_list?caller.id=${senderId}”

URL para IMPRESSÃO:

 “/shipment_pickup_list/${jsonResponse.id}?savePdf=Y&caller.id=${senderId}&response_type=PDF”

Estamos disponibilizando uma melhoria que irá juntar os dois recursos em apenas um. O novo recurso unificado será acessado, tanto para criação quanto para impressão, da seguinte forma:

 url: “/shipment_pickup_list?caller.id=${senderId}&response_type=PDF”
method: POST
params: 
response_type: Tipo de resposta desejada (pdf/json), values: PDF,JSON
data: 
{
    shipment_ids: [
        id1,
        id2,
        ...
        idN
    ]
}

response status: 201
response data JSON: 
{
    "id": pickupListId,
    "status": pickupListStatus,
    "date": pickupListDateCreated,
    "shipments": [
        {
            "id": shippingId,
            "service": [
                "id": serviceId,
                "name": serviceName
            ]
            ...
        }
    ]
}

response data PDF: PDF file. ("fileName"+PLP_ID+".pdf")

Validação de INSCRIÇÃO ESTADUAL

Atualmente quando é enviado um JSON para o recurso INVOICE_DATA que é ISENTO de inscrição estadual, muitos integradores enviam desde um valor em branco, até sequências de algarismos (000000000000, 111111111111, …), e etc. O Mercado Livre passará a VALIDAR a inscrição estadual enviada. E não apenas se está em branco ou se estão sendo enviadas sequências de caracteres, a validação se estende para uma fórmula que valida uma inscrição estadual (assim como já existe com relação ao campo CPF).

No caso de inscrições estaduais ISENTAS, deverá ser enviado ao recurso, no campo COMPANY_STATE_TAX_ID, apenas a palavra ˜ISENTO˜. Exemplo:

 POST "/shipments/${shipmentId}/invoice_data
{
    "fiscal_key": "123123123123",
     "additional_data": {
          "CFOP": 5234,
          "company_state_tax_id": “ISENTO”
      }
}

No caso de existir uma inscrição estadual, essa inscrição estadual deverá ter NO MÁXIMO 14 CARACTERES, e deverão ser enviados para o recurso apenas os números da inscrição SEM MÁSCARA.

Se for enviada uma inscrição inválida, o retorno será:

ErrorStatus: 400
Message: “Invalid State Tax Id”