Envia
A rota envia será utilizada para enviarmos um RPS para a prefeitura que irá converter em uma NFS-e, a comunicação é síncrona, portanto o retorno da requisição que fizermos, será a resposta do SaaS dizendo se a nota foi autorizada, rejeitada ou ainda se está em processamento por parte da prefeitura.
POST
https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfse/envia
Headers
Nome | Descrição | Exemplo |
Content-Type | Indica o tipo de arquivo | application/x-www-form-urlencoded |
Authorization |
Este usuário e senha são os seus dados para acessar a interface Web do grupo desejado do SaaS, localizado em https://managersaas.tecnospeed.com.br:8081 Este parâmetro deve ser gerado a partir de um Base64 da seguinte informação: usuario:senha |
Para o exemplo de usuario:senha = admin:1234, o valor gerado é: Basic YWRtaW46MTIzNA== |
Body
Nome | Descrição |
Grupo | Nome do grupo |
CNPJ | CNPJ do emitente da NFSe, apenas números |
NomeCidade | Nome da cidade do emitente Ex: CidadeUF |
Arquivo | Conteúdo do TX2 |
encode | Tratamento de encode da resposta do manager SaaS. Enviar com o valor true |
Retorno
Exemplo de retorno de sucesso:
"Handle", "Número Lote", "Número NFSe", "Mensagem"
8, 8594, 1344, RPS Autorizada com sucesso
Exemplo de retorno com erro:
"Palavra Exception", "Classe da Exception", "Mensagem de Exception"
EXCEPTION,EspdManNFSeCheckParamsException,Erro ao montar notas - Formato: t não é aceito
Exemplo de retorno com processamento pendente:
Lote ainda em processamento\delimiter o mesmo pode ser resolvido na próxima recuperação de pendência ou manualmente.
Atenção!
Quando tratamos de envio em lote, devemos ficar atentos ao formato do retorno. Temos duas situações que devemos considerar:
Retorno Situação 1
8, 8594, 1344, RPS Autorizada com sucesso
9, 8594, 1345, RPS Autorizada com sucesso
10, 8594, 1346, RPS Autorizada com sucesso
11, 8594, 1347, RPS Autorizada com sucesso
12, 8594, 1348, RPS Autorizada com sucesso
Nesse caso cada linha do retorno do lote será uma nota AUTORIZADA.
Retorno Situação 2
EXCEPTION,EspdManNFSeScriptsConverterException,Erro ao montar notas - Erro durante a execução do script. Mensagem do parser:
Exception: Para essa cidade o campo "CepTomador" não deve ser Maior que 8 Caracteres
Script: LoadEnvio
Arquivo: "..\\Comuns\\RotinasLerSetarCampos.txt"
Linha: 294 Coluna: 9
Caso o primeiro campo com a palavra EXCEPTION todo o lote será considerado inválido.
Obs: Em anexo você encontra o json dessa requisição que pode ser importado no seu Postman (ou outra aplicação de requisições).
Comentários
0 comentário
Por favor, entre para comentar.