Pular para o conteúdo principal

Enviando uma nota

Erika Raugusto
Atualizado

Enviar uma nota ao PlugStorage

Esta rota envia o XML autorizado para o PlugStorage.

Para importar um XML de NF-e, é necessário que seja validado corretamente no Validador da Sefaz  .

 

POST

 

https://app.plugstorage.com.br/api/invoices?token=Token

 

 

Querystring

 

Nome Descrição
token Token de identificação da sua Software House

 

 

Headers

 

Nome Valor
authorization Basic encode64(email:senha)==
Content-Type application/x-www-form-urlencoded

 

 

Body

 

Nome Descrição Obrigatório
xml Xml da nota a ser enviada. Pode ser enviado tanto como string, quando como arquivo dentro do form-data, ficando a critério do cliente.
  • NFS-e: Sim
  • Outros documentos: Sim
mod

Informe com o valor "99" quando for enviar uma NFS-e. Será retornado erro caso enviar uma NFS-e sem esse valor ou enviar outro documento com esse campo.
  • NFS-e: Sim
  • Outros documentos: Não é necessário informar
ambiente

Informe esse campo com 1 para indicar se a NFS-e é de produção ou 2 para homologação
  • NSF-e: Obrigatório
  • Outros documentos: Não é necessário informar
codigoCidade

Informe o Código do Município do Prestador.
  • NFS-e: Opcional. Mas, caso a cidade não seja identificada a partir das informações do XML, sua informação será obrigatória.
  • Outros documentos: Não informar

 

OBS.: Alguns padrões de prefeitura e cidades não estão homologadas, podendo negar a importação do XML através do PlugStorage.

Possíveis retornos:

  • "O código da cidade informado é inválido ou inexistente. Por favor, verifique o valor preenchido e tente novamente.", verifique se o código do município está correto e siga com o reenvio.

  • "O município informado ainda não está homologado para envio de notas com este layout. Caso tenha dúvidas, entre em contato com nosso suporte pelo chat.", significa que a cidade ainda não está habilitada para emissão nesse formato.

Caso o XML de sua cidade não for aceito, entre em contato com nossa Consultoria Técnica para análise.

Retorno

 

Exemplo de retorno para NSF-e:

<?xml version="1.0" encoding="utf-8"?>

<response>

<status_code>200</status_code>

<message>Nota salva com sucesso</message>

</response>

 

Exemplo de retorno para outros documentos:

 

<?xml version="1.0" encoding="utf-8"?>

<response>

<status_code>200</status_code>

<message>Nota salva com sucesso</message>

<hash>XMF2001000000154</hash>

<link>https://app.notasegura.com.br/invoices/index/xml/XMF2001000000154</link>

<id>8027503</id>

</response>

 

 

Exemplo de retorno para cancelamento de CFe:

 

<?xml version="1.0" encoding="utf-8"?>
<response>
<error>false</error>
<status_code>200</status_code>
<message>XML do CF-e de cancelamento salvo com sucesso</message>
</response>

 

Exemplo de retorno com erro:

<?xml version="1.0" encoding="utf-8"?>

<response>

<message>XML de nota com sintaxe quebrada ou inválida: Opening and ending tag mismatch: is line 1 and tpEmis

</message>

</response>

 

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.