API de Facturación Electrónica

Introducción

Esta API permite emitir documentos electrónicos válidos ante la SET (Subsecretaría de Estado de Tributación) de Paraguay a través del sistema SIFEN.

¿Qué es SIFEN?

SIFEN (Sistema Integrado de Facturación Electrónica Nacional) es el sistema oficial de la SET para la emisión de documentos electrónicos en Paraguay.

Documentos Soportados

Componentes del Documento Electrónico

Endpoints de la API

Base URL: https://tu-dominio.com/invoicing

[
  {
    "id": "abc-123-def",
    "name": "Mi Empresa SRL",
    "ruc": "80012345-6",
    "business_name": "MI EMPRESA SOCIEDAD DE RESPONSABILIDAD LIMITADA"
  }
]

{
  "cliente": {
    "ruc": "80009735-1",
    "razonSocial": "ANDE",
    "direccion": "Av. España",
    "numeroCasa": "1234",
    "tipoContribuyente": 2,
    "tipoOperacion": 3,
    "email": "cliente@ande.gov.py"
  },
  "items": [
    {
      "codigo": "PROD-001",
      "descripcion": "Silla de Oficina",
      "cantidad": 1.0,
      "precioUnitario": 150000,
      "ivaTipo": 10,
      "unidadMedida": 77
    }
  ],
  "condicion": {
    "tipo": 1,
    "entregas": [
      {
        "tipo": 1,
        "monto": 150000,
        "moneda": "PYG"
      }
    ]
  },
  "moneda": "PYG",
  "observacion": "Factura de prueba"
}

{
  "ns2:rRetEnviDe": {
    "ns2:rProtDe": {
      "ns2:dEstRes": "Aprobado",
      "ns2:dProtAut": "12345678901234567890",
      "ns2:gResProc": {
        "ns2:dCodRes": "0260",
        "ns2:dMsgRes": "Aprobado"
      }
    }
  },
  "cdc": "01800123456001001000104720241201000000011234567890",
  "qr_url": "https://ekuatia.set.gov.py/consultas/qr?nVersion=150&Id=...",
  "xml_signed": "..."
}

{
  "motivo": 2,
  "documentoAsociado": {
    "cdc": "01800123456001001000104720241201000000011234567890",
    "tipo": 1
  },
  ...resto de campos igual que factura
}

{
  "cliente": {...},
  "items": [
    {
      "codigo": "PROD-001",
      "descripcion": "Silla de Oficina",
      "cantidad": 5,
      "unidadMedida": 77
    }
  ],
  "moneda": "PYG",
  "observacion": "Traslado a sucursal"
}

{
  "ns2:rResEnviConsRUC": {
    "ns2:xContRUC": {
      "ns2:dRUC": "80009735-1",
      "ns2:dRazSoc": "ADMINISTRACION NACIONAL DE ELECTRICIDAD",
      "ns2:dNomFan": "ANDE",
      "ns2:dEstRUC": "Activo"
    }
  }
}

{
  "cdc": "01800123456001001000104720241201000000011234567890",
  "motivo": "Error en datos del cliente"
}

Generación de XML SIFEN

La API genera automáticamente el XML según las especificaciones SIFEN v150.

Proceso de Generación

Ejemplo de XML Generado

<?xml version="1.0" encoding="UTF-8"?>
<rDE xmlns="http://ekuatia.set.gov.py/sifen/xsd">
  <DE Id="01800123456001001000104720241201000000011234567890">
    <dVerFor>150</dVerFor>
    <gOpeDE>
      <iTipEmi>1</iTipEmi>
      <dDesTipEmi>Normal</dDesTipEmi>
      <dCodSeg>669880626</dCodSeg>
    </gOpeDE>
    <gTimb>
      <iTiDE>1</iTiDE>
      <dDesTiDE>Factura electrónica</dDesTiDE>
      <dNumTim>03970287</dNumTim>
      <dEst>001</dEst>
      <dPunExp>001</dPunExp>
      <dNumDoc>0000001</dNumDoc>
      <dFeIniT>2024-01-01</dFeIniT>
    </gTimb>
    <gDatGralOpe>
      <dFeEmiDE>2024-12-01T10:30:00</dFeEmiDE>
    </gDatGralOpe>
    <gEmis>
      <dRucEm>80012345-6</dRucEm>
      <dRazSocEm>MI EMPRESA SRL</dRazSocEm>
      ...
    </gEmis>
    <gDatRec>
      <dRucRec>80009735-1</dRucRec>
      <dRazSocRec>ANDE</dRazSocRec>
      ...
    </gDatRec>
    <gDtipDE>
      <gCamFE>
        <gCamItem>
          <dCodInt>PROD-001</dCodInt>
          <dDesProSer>Silla de Oficina</dDesProSer>
          <dCantProSer>1.0</dCantProSer>
          <dPUniProSer>150000</dPUniProSer>
          ...
        </gCamItem>
      </gCamFE>
    </gDtipDE>
  </DE>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...firma digital...
  </Signature>
  <dCarQR>https://ekuatia.set.gov.py/consultas/qr?...</dCarQR>
</rDE>

Campos Automáticos

La API genera automáticamente los siguientes campos:

Ejemplos de Uso

Python

import requests

url = "https://api.ejemplo.com/invoicing/emit/invoice"
params = {"company_id": "abc-123"}

factura = {
    "cliente": {
        "ruc": "80009735-1",
        "razonSocial": "ANDE",
        "direccion": "Av. España",
        "numeroCasa": "1234",
        "tipoContribuyente": 2,
        "email": "cliente@ande.gov.py"
    },
    "items": [{
        "codigo": "PROD-001",
        "descripcion": "Producto",
        "cantidad": 1,
        "precioUnitario": 100000,
        "ivaTipo": 10
    }],
    "condicion": {
        "tipo": 1,
        "entregas": [{"tipo": 1, "monto": 100000, "moneda": "PYG"}]
    },
    "moneda": "PYG"
}

response = requests.post(url, params=params, json=factura)
result = response.json()

print(f"CDC: {result['cdc']}")
print(f"QR: {result['qr_url']}")

cURL

curl -X POST "https://api.ejemplo.com/invoicing/emit/invoice?company_id=abc-123" \
  -H "Content-Type: application/json" \
  -d '{
    "cliente": {
      "ruc": "80009735-1",
      "razonSocial": "ANDE",
      "direccion": "Av. España",
      "numeroCasa": "1234",
      "tipoContribuyente": 2,
      "email": "cliente@ande.gov.py"
    },
    "items": [{
      "codigo": "PROD-001",
      "descripcion": "Producto",
      "cantidad": 1,
      "precioUnitario": 100000,
      "ivaTipo": 10
    }],
    "condicion": {
      "tipo": 1,
      "entregas": [{"tipo": 1, "monto": 100000, "moneda": "PYG"}]
    },
    "moneda": "PYG"
  }'

Códigos de Error

Errores Comunes

Códigos de Respuesta SIFEN

Esquema de Datos Completo

Cliente (ClientSchema)

Item (ItemSchema)

* No requerido para notas de remisión

Tipos de IVA