FactpyEmitir

Descripción

Crea y envía un Documento Electrónico (DE) al SIFEN (Sistema Integrado de Facturación Electrónica Nacional) de Paraguay a través de FactPy. El nodo devuelve el CDC (Código de Control) único asignado por la SET y la URL del KuDE (representación visual del DE).

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	API key de la cuenta FactPy
document_type	select	No	Tipo de DE (default: 1=Factura)
currency	select	No	PYG=Guaraní, USD, EUR (default: PYG)
establishment	text	No	Código de establecimiento (default: 001)
point	text	No	Punto de expedición (default: 001)
condition	select	No	1=Contado, 2=Crédito (default: 1)
date	text	No	Fecha YYYY-MM-DD (default: hoy)
observations	text	No	Observaciones del DE
receiver	object	Si	Objeto JSON con datos del receptor
items	array	Si	Array JSON con los conceptos del DE

Tipos de Documento

Código	Tipo
1	Factura Electrónica
4	Nota de Crédito Electrónica
5	Nota de Débito Electrónica
6	Nota de Remisión Electrónica
11	Factura de Exportación

Credenciales

Requiere una credencial de tipo factpy con:

• API Key: clave de acceso disponible en el panel de FactPy
• Entorno: sandbox (pruebas) o production (SET real)

Estructura del receptor

{
  "ruc": "80012345-6",
  "name": "Empresa Cliente S.A.",
  "address": "Av. España 1234, Asunción",
  "email": "cliente@empresa.com.py",
  "phone": "0981123456"
}

Para personas físicas usar ci en lugar de ruc. Para extranjeros usar el documento de identidad.

Estructura de ítems

[
  {
    "description": "Servicio de desarrollo de software",
    "quantity": 1,
    "unit_price": 5000000,
    "iva_rate": 10,
    "unit": "SRV"
  }
]

IVA en Paraguay: 10% (tasa general), 5% (bienes de primera necesidad), 0% (exento).

Salida

{
  "success": true,
  "document_id": "de-abc123",
  "cdc": "01800123456001001000001234567890123456789012",
  "document_type": 1,
  "status": "approved",
  "kude_url": "https://app.factpy.com/kude/de-abc123",
  "raw": { ... }
}

Ejemplo de Uso

{
  "credentials_id": "cred-factpy-prod",
  "document_type": "1",
  "currency": "PYG",
  "establishment": "001",
  "point": "001",
  "condition": "1",
  "receiver": {
    "ruc": "80012345-6",
    "name": "Empresa Cliente S.A.",
    "address": "Mcal. López 1234, Asunción",
    "email": "admin@cliente.com.py"
  },
  "items": [
    {
      "description": "Servicio de consultoría",
      "quantity": 1,
      "unit_price": 2500000,
      "iva_rate": 10,
      "unit": "SRV"
    }
  ]
}

Notas

• El CDC es el identificador único del DE ante la SET — debe guardarse para cancelaciones y consultas
• El KuDE es la representación visual del DE (similar a un PDF) que se entrega al receptor
• La SET puede tardar unos segundos en procesar el DE; consultar con factpyConsulta si el estado es pendiente

Nodos Relacionados

• FactpyConsulta - Consultar estado de un DE
• FactpyCancelar - Cancelar un DE