Fluxo para integração com o produto NFeLoja

 

Este documento tem como objetivo documentar o fluxo para integração via API com a solução NFeLoja. Documentação detalhada sobre as API’s citadas, devem ser consultadas nos link’s mencionados. 

 

Para um melhor entendimento podemos dividir em dois cenários: Configuração e Operação. 

 

Operações para Configuração

Passo 1: Realizar o cadastro da empresa na solução Vinco

O cadastro deverá ser realizado pelo método Cadastrar Empresa, cujo endereço é o: https://nfe.vinco.com.br/nfe/api/v1/Partner/CadastrarEmpresa 

 

Neste método deverá ser informado os dados principais da empresa (CNPJ, Razão Social etc) e também o IdKeyEmpresaPai (empresa raiz do parceiro na solução) .

Documentação está disponível em: http://nfe.vinco.com.br/NFe/swagger/ui/index#/Partner/Partner_CadastrarEmpresa  

Passo 2:  Adicionar certificado A1 do cliente

A adição do certificado pode ser realizada pelo método AdicionaCertificadoDigital, cujo endereço é o: https://nfe.vinco.com.br/nfe/api/v1/Partner/AdicionarCertificadoDigital 

 

Este método espera o binário do arquivo do certificado, junto com a senha.

 

Documentação está disponível em: http://nfe.vinco.com.br/NFe/swagger/ui/index#/Partner/Partner_AdicionarCertificadoDigital

 

Passo 3: Configurar informações da empresa

Neste passo pode ser feito pela função AlterarInformacoes, cujo o endereço é o https://nfe.vinco.com.br/nfe/api/v1/Partner/AlterarInformacoes

Este método permite configurar o Logotipo da Empresa, adicionar servidor SMTP para envio de e-mail, como também configurar o código CSC para NFCe. 

 

Documentação está disponível em: http://nfe.vinco.com.br/NFe/swagger/ui/index#/Partner/Partner_AlterarInformacoes

 

Passo 4:  Criar usuário para cliente no NFeLoja

 

Foi criado uma API para permitir a criação de usuário no NFeLoja. 

 

Este usuário e senha deverá ser enviado ao cliente para que ele possa realizar a configuração tributária pelo portal. Este passo será melhor detalhado a frente.

 

A documentação da API ainda está sendo disponibilizada, mas seu endereço é o: https://dfecomfort2.vinco.com.br/api/Partner/CriarUsuarioAdministrativoDaLoja

 

Documentação em breve no link: http://dfecomfort2.vinco.com.br/swagger/ui/index#/Partner/Partner_CriarUsuarioAdministrativoDaLoja

 

Passo 5: Cadastro de Produtos no NFeLoja

 

Este método permite a inserção dos produtos usados na venda no NFeLoja.

O endereço é o: https://dfecomfort2.vinco.com.br/api/NFe/CadastrarProdutos

 

Sempre que um produto novo surgir, deverá ser utilizado este método para cadastro. 

 

Documentação disponível em: https://dfecomfort2.vinco.com.br/swagger/ui/index#/NFe/NFe_CadastrarProdutos

 

Passo 6: Configuração tributária do Produto

 

O usuário deverá acessar o site https://dfecomfort2.vinco.com.br/, realizar o login e fazer a configuração do NCM (Configuração => NCM) ou Produto (Configuração => Produto).  

 

O tutorial sobre as configurações pode ser acessado no link: https://dfecomfort2.vinco.com.br/Ajuda/Ajuda.aspx item 3.5 Configurando Tributos Iniciais da Loja.

 

Operações para emissão

 

Passo 7: Emissão de NFe e NFCe

 

A emissão de NFe ou NFCe está disponível no endereço: https://dfecomfort2.vinco.com.br/api/NFe/Autorizar

 

Documentação disponível em: https://dfecomfort2.vinco.com.br/swagger/ui/index#/NFe/NFe_Autorizar

 

Métodos auxiliares para recuperar informações ou realizar outras operações

 

Método Consultar Situação NFe/NFCe

 

Serviço responsável pela consulta de status dos documentos NFe ou NFCe. Está disponível no endereço: https://dfecomfort2.vinco.com.br/api/NFe/ConsultarSituacaoNFeNFCe 

 

Documentação disponível em: https://dfecomfort2.vinco.com.br/swagger/ui/index#/NFe/NFe_ConsultarSituacaoNFeNFCe