FactpyEmitir

Description

Creates and submits an Electronic Document (DE) to Paraguay’s SIFEN (Sistema Integrado de Facturación Electrónica Nacional) through FactPy. The node returns the CDC (Código de Control) unique code assigned by the SET and the KuDE URL (visual representation of the DE).

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	FactPy account API key
document_type	select	No	DE type (default: 1=Invoice)
currency	select	No	PYG=Guaraní, USD, EUR (default: PYG)
establishment	text	No	Establishment code (default: 001)
point	text	No	Point of issue (default: 001)
condition	select	No	1=Cash, 2=Credit (default: 1)
date	text	No	Date YYYY-MM-DD (default: today)
observations	text	No	DE observations
receiver	object	Yes	JSON object with receiver data
items	array	Yes	JSON array with DE line items

Document Types

Code	Type
1	Electronic Invoice
4	Electronic Credit Note
5	Electronic Debit Note
6	Electronic Remission Note
11	Export Invoice

Credentials

Requires a factpy credential type with:

• API Key: access key from the FactPy settings panel
• Environment: sandbox (testing) or production (real SET)

Receiver object

{
  "ruc": "80012345-6",
  "name": "Client Company S.A.",
  "address": "Av. España 1234, Asunción",
  "email": "client@company.com.py",
  "phone": "0981123456"
}

Use ci instead of ruc for individuals. For foreign recipients, use their ID document.

Items array

[
  {
    "description": "Software development service",
    "quantity": 1,
    "unit_price": 5000000,
    "iva_rate": 10,
    "unit": "SRV"
  }
]

Paraguay VAT rates: 10% (general), 5% (basic goods), 0% (exempt).

Output

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

Usage Example

{
  "credentials_id": "cred-factpy-prod",
  "document_type": "1",
  "currency": "PYG",
  "receiver": {
    "ruc": "80012345-6",
    "name": "Client Company S.A.",
    "address": "Mcal. López 1234, Asunción",
    "email": "admin@client.com.py"
  },
  "items": [
    {
      "description": "Consulting service",
      "quantity": 1,
      "unit_price": 2500000,
      "iva_rate": 10,
      "unit": "SRV"
    }
  ]
}

Notes

• The CDC is the unique DE identifier with SET — store it for cancellations and queries
• The KuDE is the visual representation of the DE (similar to PDF) delivered to the receiver
• The SET may take a few seconds to process the DE; query with factpyConsulta if status is pending

Related Nodes

• FactpyConsulta - Query DE status
• FactpyCancelar - Cancel a DE