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/manifests?token=Token
Querystring
| Nome | Descrição |
|---|---|
| token | Token de identificação da sua Software House |
Headers
| Nome | Descrição |
|---|---|
| Authorization | Basic encode64(email:senha) |
| 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
OBS.: Para CTE, o type disponível é DESACORDO e é enviado como default por nossa aplicação, não sendo necessário o cliente informar este campo para CTE |
| 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 |
*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. |
invoice_mod - valores válidos: NFE e CTE
type - Valores aceitos para o campo type para NF-e: CONFIRMAR, DESCONHECIMENTO, NAO_REALIZADA ou 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)
environment - valores validos: 1 ou 2 (Produção/Homologação)
datetime - formato: AAAA-MM-DD HH:MM:SS (Ano:Mês:Dia Hora:Minuto:Segundo)
invoices: é necessário informar de 1 até 50 documentos
cancel_disaccord - valores validos: 0 ou 1 (Não cancelar / Solicitar Cancelamento) 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.