Ajuda do Produto
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
- Detalhes
- Escrito por Bento Alves
- Publicado: 08 Janeiro 2021
- Última atualização: 08 Janeiro 2021