Cadastro de Produtos
Para emissão de notas fiscais será necessário a criação de produtos, como segue a imagem abaixo:
Para cadastrar o produto iremos precisar de alguns dados: Token de autenticação do usuário, cnpj da empresa, o código do produto que vai ser armazenado internamente para referenciar aquele produto, o nome do poduto e o ncm do produto.
Para verificar se o produto foi cadastrado, basta logar no sistema e realizar a busca através do ncm, nome ou código do produto.
Para saber mais sobre a busca de produtos no sistema, basta entrar nesse link: Segue o link do manual aqui
Atualização de Produtos
Para realizar a atualização do produto vai ser necessário o token e o CNPJ da empresa. Para realizar a mudança do produto será preciso informar o código do produto, nome ou o ncm do produto. Nesse caso iremos alterar somente o nome do produto e o ncm continuará o mesmo.
Segue a imagem do antes e depois:
Para verificar se o produto foi alterado, basta realizar o login no sistema e realizar a busca através do código ou nome do novo produto.
Para saber mais sobre a busca de produtos no sistema, basta entrar nesse link: Segue o link do manual aqui: Segue o link do manual aqui
Removendo Produtos
Para realizar a remoção do produto o usuário precisará do token, cnpj e o código do produto. No caso da remoção do produto, não precisará informar o nome do produto e nem o seu ncm.
Segue a imagem abaixo:
Caso o usuário queira conferir se o produto foi removido, basta acessar o menu de produto e pesquisa pelo código, nome ou ncm do produto que foi removido. Ele não irá mais aparecer, porque ele foi removido do sistema.
Caso o usuário queria ver essa demonstração da API na prática, iremos disponibilizar o vídeo explicativo de como funciona a nossa API via postman, com uma explicação detalhada e bem prática.
Emissão de Notas Fiscais
No corpo da mensagem existe dois campos de autenticação: token (Feita por uma sequência de caracteres do usuário) e cnpj que é uma informação da empresa. Dessa forma o usuário pode saber para qual empresa a nota irá ser criada, qual empresa vai agir como emissora da nota fiscal, e através do token o sistema vai saber se o usuário do token vai ter permissão de acesso a empresa através do cnpj.
Segue a imagem abaixo:
Ao lado do CNPJ, especifica-se o tipo de nota que queremos emitir, se o modelo da nota vai ser NFE ou NFCE. Depois o usuário especifica o modelo de ambiente (Homologação ou Produção), e após isso, qual o tipo de operação. Para mais detalhes consulte a documentação/referencia a API. Em destinatário, temos as informações do usuário que irá receber as notas fiscais. Para mais duvidas, consulte a documentação/manual do usuário.
Obs: Em relação a “inscrição estadual” só será necessário se o cliente for uma empresa, sendo também requerido o preenchimento do campo "indicador_contribuinte"
Buscar Notas Fiscais
A API de busca em notas fiscais serve para encontrar uma nota especifica, assim ela vai receber apenas uma única chave. Além disso vai precisar dos dados de autenticação que são so tokens e cnpj. Segue a imagem abaixo:
Segue a imagem abaixo:
Após fazer a busca, ele vai retornar os dados do formato selecionado.
Obs: Ele vai retornar o modelo dependendo de qual “Tipo de retorno de nota fiscal” que tiver na configuração de empresa. Caso o retorno for em outro formato, ele vai retornar esse formato na pesquisa.
Para mais duvidas do tipo de retorno de nota fiscal: Segue o link do manual aqui!
Nota de Devolução
Para realizar uma nota de devolução o tipo dela terá que ser NFE, já que não é possível realizar uma devolução com o tipo NFCE.
Como estamos devolvendo uma nota de saída, então o tipo de devolução tem que ser de entrada para que o produto retorne ao estoque da empresa que originalmente continha o produto.
Exportação Nota Fiscal
Para realizar a exportação da nota fiscal será necessário o token, CNPJ e o tipo da nota fiscal como é representado na imagem abaixo:
Após o usuário fazer a exportação, ele receberá um aquivo .zip em sua máquina e irá visualizar duas paginas contendo os formato dos arquivos ao qual ele exportou. No caso seguindo o exemplo acima, ele irá visualizar os formatos pdf e xml dentro do arquivo zip, contendo as notas ao qual ele fez a emissão.
Cancelar Nota Fiscal
Para realizar o cancelamento da nota fiscal, é necessário que a nota fiscal seja emitida dentro do sistema, assim quando você realizar o cancelamento da nota fiscal, o usuário precisará passar os dados que foram representados a imagem acima.
Para verificar o cancelamento da nota fiscal dentro do sistema, o usuário precisará filtrar por notas canceladas no menu nota fiscal e visualizar a nota. Nesse momento a nota fiscal será seguida por um protocolo de cancelamento junto com a data de cancelamento.
Caso queira conferir se a nota fiscal foi realmente cancelada, o usuário pode entrar nesse link: Segue o link do portal da sefaz
Segue o link do portal da sefaz
Video tutorial