Avaliar integração
API SIFEN · PARAGUAI

Faturamento eletrônico integrado ao seu sistema.

A Adelantos conecta seu ERP, POS, e-commerce ou plataforma própria ao SIFEN por meio de uma API REST com rastreabilidade operacional e dados de auditoria, desenvolvida sobre a tecnologia do Pymes Guru.

Onboarding técnico e conta do Pymes Guru incluídos
api.sifenv1
POST/operaciones/lotefactura
200Lote recebido pela API
01
CDC gerado0180···678901
02
Acompanhamento habilitadoLOTE · CDC · EVENTOS
SIFENJSONOIDC
DUAS FORMAS DE INTEGRAR

Para equipes técnicas e empresas.

Podemos acompanhar quem desenvolve a integração ou conduzir o projeto completo com a empresa.

</>PARA INTEGRADORES

Mantenha seu produto. Adicione o SIFEN.

Uma interface REST/JSON para equipes que já operam um ERP, POS, e-commerce ou solução vertical.

  • Ambientes de desenvolvimento e QA
  • Autenticação OIDC
  • Correlação e rastreabilidade operacional
PARA EMPRESAS

Conectamos o sistema que você já usa.

Analisamos sua operação e definimos se é mais conveniente fazer uma integração direta ou incorporar o Pymes Guru.

  • Avaliação técnica inicial
  • Mapeamento do fluxo de faturamento
  • Acompanhamento até o aceite
ESCOPO ATUAL

O fluxo essencial do faturamento eletrônico.

A integração abrange emissão, consulta e acompanhamento, com respostas que seu sistema pode processar e conciliar.

RUC
01

Consulta de contribuintes

Validação das informações do contribuinte por meio de uma consulta ao SIFEN.

02

Envio em lotes

Registro e envio de documentos eletrônicos a partir de cargas JSON estruturadas.

CDC
03

CDC e consulta por QR

Obtenção dos identificadores CDC e do link de consulta associado ao documento.

04

Status do documento

Consulta do lote, do resultado por documento e das mensagens retornadas durante o processamento.

05

Eventos do documento

Fluxos de cancelamento e inutilização avaliados durante o onboarding de cada integração.

06

Auditoria e rastreabilidade

Dados de auditoria de envios, consultas e eventos — incluindo lote, CDC, status, mensagens e correlação, quando aplicável — para acompanhamento e suporte técnico.

ARQUITETURA SIMPLES

Seu sistema mantém o controle do negócio.

A API atua como camada de integração, e a Adelantos acompanha a configuração, os testes e a entrada em operação.

01
</>

Seu sistema

ERP, POS, e-commerce ou software próprio prepara os dados do documento.

02

API Adelantos

Recebe JSON, transforma o documento e gerencia a comunicação com o SIFEN.

03

SIFEN

Processa o documento e retorna lotes, CDC, status e mensagens.

API Adelantos+Pymes Guru
RESPONSABILIDADES CLARAS

Uma integração acompanhada, não uma caixa-preta.

A Adelantos gerencia

  • Onboarding técnico e ambientes
  • Configuração do emissor e do certificado
  • Mapeamento, testes e acompanhamento
  • Diagnóstico com IDs de correlação
</>

O integrador gerencia

  • Dados e regras de sua operação
  • Numeração e consistência documental
  • Tratamento das respostas de negócio
  • Armazenamento seguro de credenciais e dados
PROCESSO DE INCORPORAÇÃO

Da avaliação a uma integração aceita.

Não entregamos uma chave genérica: cada implantação é analisada, configurada e testada com um escopo definido.

01

Levantamento

Sistema atual, documentos, volume, filiais e fluxo operacional.

02

Mapeamento técnico

Contrato de dados, autenticação, ambientes e responsabilidades.

03

Testes em QA

Casos de aceite, respostas de negócio e conciliação por CDC.

04

Habilitação

Configuração final, checklist operacional e canal de suporte acordado.

RESUMO TÉCNICO

Projetada para integração com tecnologias atuais.

INTERFACEREST + JSON
AUTENTICAÇÃOOIDC Bearer
AMBIENTESDEV · QA · PROD
AUDITORIAOperação · Lote · CDC · Correlação
PERGUNTAS FREQUENTES

Antes de iniciar uma integração.

O escopo final depende do sistema, do fluxo documental e da situação de cada empresa perante o SIFEN.

O serviço de API inclui acesso ao Pymes Guru?

Sim. Inclui acesso a uma conta associada do Pymes Guru como interface complementar para visualização, gestão e processos que o sistema do cliente ainda não tenha integrado. Usuários, perfis e permissões são acordados durante o onboarding.

Posso conectá-la a um ERP ou POS existente?

Sim. O objetivo é integrar sistemas que já geram as informações comerciais necessárias, depois da análise de seu modelo de dados e processo.

A documentação técnica é pública?

A documentação de integração é fornecida durante o onboarding, com versão correspondente ao ambiente e ao escopo acordados.

A API substitui os requisitos do SIFEN?

Não. Ela simplifica a integração técnica, mas a empresa e seu integrador devem cumprir os requisitos aplicáveis e validar sua operação.

Quais dados de auditoria estão disponíveis?

São registrados dados de rastreabilidade das operações processadas, como tipo de operação, data e hora, lote ou CDC, status, mensagens e correlação, quando aplicável. Os campos exatos, o canal de consulta, o acesso e a retenção dependem do ambiente e do escopo acordados; eles não substituem os registros contábeis ou legais que a empresa deve conservar.

Existe um preço único?

A proposta depende do volume, das operações necessárias, do sistema atual e do acompanhamento necessário.

VAMOS FALAR SOBRE SEU SISTEMA

Quer avaliar uma integração com o SIFEN?

Conte-nos qual sistema você usa, quais documentos precisa processar e seu volume aproximado. Analisamos o caso antes de definir o escopo e as condições.

Consultar sobre a API SIFENLigar para a Adelantos
Serviço independente de integração tecnológica. A Adelantos não representa a DNIT, e esta página não substitui a documentação oficial do SIFEN.