Rota para solicitação de processamento de Manifesto Do Destinatário, Desacordo com a Prestação do Serviço ou Cancelamento Prestação do Serviço em Desacordo. Esse processamento é assíncrono, é necessário que seja feita consulta para obter as informações de retorno da solicitação
POST
https://app.plugstorage.com.br/api/v2/manifests
Headers
| Nome | Valor | Descrição |
|---|---|---|
| Authorization | Basic encode64(TokenSH:senha) | Token de identificação da sua Software House : Senha do usuário da Software House |
| Content-Type | application/x-www-form-urlencoded ou application/json |
Body
| Nome | Descrição | Obrigatório |
|---|---|---|
| invoice_mod | Modelo do documento | Sim |
| type | Tipo da manifestação | Sim - Somente para invoice_mod = NFE
|
| justify | Justificativa da manifestação | Sim - Somente para invoice_mod = NFE e type = NAO_REALIZADA |
| environment | Ambiente para manifestação ou desacordo | Sim |
datetime | Data da manifestação ou desacordo | Sim |
cnpj_cpf | CNPJ ou CPF de quem está fazendo o evento | Sim |
invoices | Lista com as chaves dos documentos | Sim |
| cancel_disaccord | Solicitar cancelamento do desacordo | Sim - Somente para invoice_mod = CTE OBS.: Para CTE, quando enviado, o seu documento precisará conter um DESACORDO Autorizado. |
Valores aceitos para o campo invoice_mod:
- NFEpara NF-e;
- CTE para CT-e.
Valores aceitos para o campo type para NF-e:
- CONFIRMAR;
- DESCONHECIMENTO;
- NAO_REALIZADA;
- CIENCIA (Essa opção só será possível caso não esteja marcada a opção de ciência automática na parametrização de consulta de destinadas da empresa)
Valores aceito para o campo environment:
- 1 para ambiente de produção;
- 2 para o ambiente de homologação.
O Campo datetime deve ser informado no seguinte formato:
- AAAA-MM-DD HH:MM:SS (Ano:Mês:Dia Hora:Minuto:Segundo);
O Campo invoices é necessário informar de 1 até 50 documentos.
Valores aceito para o campo cancel_disaccord:
- 0 para quando não desejar cancelar um desacordo
- 1 para solicitar o cancelamento de um desacordo
Obs: Campo cancel_disaccord opcional para o valor 0
Exemplo de body (NF-e):
{
"invoice_mod": "NFE",
"type": "CONFIRMAR",
"environment": 1,
"datetime": "2019-03-01 12:30:00",
"invoices": [
"41190218582206000132558040000003281000000012",
"41190218582206000132558040000003281000000011"
]
}Exemplo de body (CT-e desacordo):
{
"invoice_mod": "CTE",
"environment": 1,
"datetime": "2019-03-01 12:30:00",
"invoices": [
"41190218582206000132578040000003281000000012",
"41190218582206000132578040000003281000000011"
]
}Exemplo de body (CT-e Cancelamento do desacordo):
{
"invoice_mod": "CTE",
"cancel_disaccord": "1",
"environment": 1,
"datetime": "2019-03-01 12:30:00",
"invoices": [
"41190218582206000132578040000003281000000012",
"41190218582206000132578040000003281000000011"
]
}Retorno
Exemplo de retorno de validações:
{
"error": true,
"message": "Campo "environment" não informado ou inválido,
valores aceitos: 1 - (PRODUÇÃO) ou 2 - (HOMOLOGAÇÃO)"
}
Exemplo de retorno com sucesso:
{
"error": false,
"message": "Seu pedido foi realizado com sucesso."
"data": {
"manifests_errors" : [
{
"invoice_key": "41190218582206000132558040000003281000000012",
"message": "Nota já se encontra em processamento ou processada."
}
],
"manifests_success": [
{
"manifest_id": 1,
"invoice_key": "41190218582206000132558040000003281000000011",
}
]
}
}
Exemplo de retorno com erro:
{
"error": true,
"message": "Nenhum pedido de realizado, verifique o retorno."
"data": {
"manifests_errors" : [
{
"invoice_key": "41190218582206000132558040000003281000000012",
"message": "Nota já se encontra em processamento ou processada."
}
],
"manifests_success": []
}
}
Comentários
0 comentário
Por favor, entre para comentar.