api.goekua.com.py Última actualización: 15 Jul 2026

Documentación de API

Bienvenido a la API de Goekua. Nuestra plataforma le permite integrar la facturación electrónica directamente en sus sistemas empresariales, automatizando procesos financieros con la máxima seguridad y cumplimiento legal. Todos los endpoints están disponibles en https://api.goekua.com.py. Explore nuestros endpoints para gestionar documentos electrónicos, clientes, certificados y recibos de dinero de forma programática.

Conocé el Plan API y solicitá tu cotización arrow_forward
bolt

Integración Rápida

Arquitectura REST para una implementación en cuestión de horas.

security

Seguridad Bancaria

Cifrado de extremo a extremo y autenticación robusta por API Keys.

check_circle

99.9% Uptime

Infraestructura escalable diseñada para alta disponibilidad.

lock

Autenticación

La API de Goekua utiliza **API Keys** para autenticar las solicitudes. Puede solicitar su clave a soporte de GOEKUA.

Todas las solicitudes a la API deben realizarse a través de HTTPS, incluyendo su clave en el encabezado x-api-key de la siguiente manera:

# Ejemplo de encabezado HTTP
x-api-key: TU_API_KEY
Content-Type: application/json
warning

Advertencia de Seguridad

Sus claves de API llevan privilegios significativos. No las comparta en repositorios públicos ni las exponga en el código del lado del cliente (frontend).

receipt_long

Genera una Factura electronica

POST /api/electronic-document/generate-invoice

Crea una nueva Factura electrónica, la firma y la envía a la SET/SIFEN para su aprobación.

Parámetros

user object Requerido

Objeto anidado (ApiCreateUserDto).

client object Requerido

Objeto anidado (ApiCreateClientDto).

establishment object Requerido

Objeto anidado (EstablishmentDto).

transactionType number Requerido

Campo iTipTra - Página 66 del manual técnico Valores posibles: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13.

operationConditionType number Requerido

Campo iCondOpe - Página 80 del manual técnico Valores posibles: 1, 2.

items array Requerido

Lista de objetos (ApiCreateItemDto).

paymentMethods array Requerido

Lista de objetos (ApiCreatePaymentMethodDto).

emissionType number Requerido

Campo iTipEmi - Página 62 del manual técnico Valores posibles: 1, 2.

presenceIndicatorType number Requerido

Campo iIndPres - Página 64 del manual técnico Valores posibles: 1, 2, 3, 4, 5, 6, 9.

expirationDate string Requerido

Obligatorio cuando operationConditionType = 2

pointOfExpedition string Requerido

Campo dPunExp

documentNumber string Requerido

Campo dNumDoc

serieNumber string

Campo dSerieNum

currency string Requerido

Campo cMoneOpe - Página 67 del manual técnico

currencyRate number Requerido

Campo dTiCam

cdc string

Campo opcional.

observation string

Campo dInfoEmi - Página 62 del manual técnico

purchaseOrderNumber string

Campo dOrdCompra - Página 106 del manual técnico

retroactiveEmissionDate string

Campo de fecha de emisión con fecha anterior a la actual

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/electronic-document/generate-invoice \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": {
      "name": "Juan",
      "lastName": "Pérez",
      "email": "cliente@empresa.com.py",
      "documentType": 1,
      "documentNumber": "",
      "position": "Gerente",
      "phone": "021123456"
    },
    "client": {
      "fantasyName": "Mi Empresa",
      "ruc": "80012345-6",
      "businessName": "Mi Empresa S.A.",
      "address": "Av. Mariscal López 1234",
      "email": "cliente@empresa.com.py",
      "email2": "contacto@empresa.com.py",
      "isContributor": false,
      "houseNumber": 0,
      "cityIdSifen": 0,
      "countryIdSifen": "",
      "contributorType": 1,
      "documentType": 1,
      "documentNumber": "",
      "phone": "021123456",
      "cellPhone": "0981123456",
      "departmentOffice": "Central",
      "addressReference": "Frente a la plaza",
      "operationType": 1
    },
    "establishment": {
      "idSifen": "001",
      "address": "Av. Mariscal López 1234",
      "houseNumber": 0,
      "cityId": 0,
      "phone": "021123456",
      "phone2": "021123457",
      "phone3": "021123458",
      "email": "cliente@empresa.com.py",
      "denomination": "Casa Matriz",
      "complementAddress1": "",
      "complementAddress2": ""
    },
    "transactionType": 1,
    "operationConditionType": 1,
    "items": [
      {
        "code": "PROD001",
        "description": "Producto o servicio de ejemplo",
        "measureUnit": 0,
        "amount": 0,
        "unitPrice": 0,
        "unitDiscountPercentage": 0,
        "unitNetDiscount": 0,
        "taxPercentage": 0,
        "taxRate": 0,
        "ivaType": 1,
        "observations": "Sin observaciones"
      }
    ],
    "paymentMethods": [
      {
        "paymentType": 1,
        "cardType": 1,
        "formOfProccessingPayment": 1,
        "issuingEntity": "",
        "chequeNumber": "",
        "charge": 0,
        "currency": "PYG",
        "currencyRate": 7282
      }
    ],
    "emissionType": 1,
    "presenceIndicatorType": 1,
    "expirationDate": "2026-07-15T00:00:00.000Z",
    "pointOfExpedition": "001",
    "documentNumber": "0000001",
    "serieNumber": "AA",
    "currency": "PYG",
    "currencyRate": 7282,
    "cdc": "",
    "observation": "Sin observaciones",
    "purchaseOrderNumber": "1234567890",
    "retroactiveEmissionDate": "2026-07-15T00:00:00.000Z"
  }'
Respuesta Exitosa (201 Created) 
{
  "id": "ID_DEL_DOCUMENTO_GENERADO"
}
receipt_long

Genera una Autofactura electronica

POST /api/electronic-document/generate-self-invoice

Crea una Autofactura electrónica (para compras a proveedores no facturadores) y la envía a la SET/SIFEN.

Parámetros

user object Requerido

Objeto anidado (ApiCreateUserDto).

seller object Requerido

Objeto anidado (ApiSellerDto).

establishment object Requerido

Objeto anidado (EstablishmentDto).

transactionOrigin object Requerido

Objeto anidado (ApiTransactionOriginDto).

transactionType number Requerido

Campo iTipTra - Página 66 del manual técnico Valores posibles: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13.

operationConditionType number Requerido

Campo iCondOpe - Página 80 del manual técnico Valores posibles: 1, 2.

taxType number Requerido

Campo iTImp - Página 66 del manual técnico Valores posibles: 1, 2, 3, 4, 5.

items array Requerido

Lista de objetos (ApiCreateSelfInvoiceItemDto).

paymentMethods array Requerido

Lista de objetos (ApiCreatePaymentMethodDto).

emissionType number Requerido

Campo iTipEmi - Página 62 del manual técnico Valores posibles: 1, 2.

presenceIndicatorType number Requerido

Campo iIndPres - Página 64 del manual técnico Valores posibles: 1, 2, 3, 4, 5, 6, 9.

expirationDate string Requerido

Obligatorio cuando operationConditionType = 2

pointOfExpedition string Requerido

Campo dPunExp

documentNumber string Requerido

Campo dNumDoc

serieNumber string

Campo dSerieNum

cdc string

Campo opcional.

observation string

Campo dInfoEmi - Página 62 del manual técnico

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/electronic-document/generate-self-invoice \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": {
      "name": "Juan",
      "lastName": "Pérez",
      "email": "cliente@empresa.com.py",
      "documentType": 1,
      "documentNumber": "",
      "position": "Gerente",
      "phone": "021123456"
    },
    "seller": {
      "natureOfSellerNonContributory": false,
      "constancyTypeNonContributory": false,
      "documentType": 1,
      "documentNumber": "",
      "nameAndSurname": "",
      "address": "Av. Mariscal López 1234",
      "houseNumber": 0,
      "constancyNumber": "",
      "constancyControlNumber": "",
      "cityIdSifen": 0
    },
    "establishment": {
      "idSifen": "001",
      "address": "Av. Mariscal López 1234",
      "houseNumber": 0,
      "cityId": 0,
      "phone": "021123456",
      "phone2": "021123457",
      "phone3": "021123458",
      "email": "cliente@empresa.com.py",
      "denomination": "Casa Matriz",
      "complementAddress1": "",
      "complementAddress2": ""
    },
    "transactionOrigin": {
      "cityIdSifen": 0,
      "address": "Av. Mariscal López 1234",
      "addressReference": "Frente a la plaza"
    },
    "transactionType": 1,
    "operationConditionType": 1,
    "taxType": 1,
    "items": [
      {
        "amount": 0,
        "unitPrice": 0,
        "description": "Producto o servicio de ejemplo",
        "measureUnit": 0,
        "taxRate": 0
      }
    ],
    "paymentMethods": [
      {
        "paymentType": 1,
        "cardType": 1,
        "formOfProccessingPayment": 1,
        "issuingEntity": "",
        "chequeNumber": "",
        "charge": 0,
        "currency": "PYG",
        "currencyRate": 7282
      }
    ],
    "emissionType": 1,
    "presenceIndicatorType": 1,
    "expirationDate": "2026-07-15T00:00:00.000Z",
    "pointOfExpedition": "001",
    "documentNumber": "0000001",
    "serieNumber": "AA",
    "cdc": "",
    "observation": "Sin observaciones"
  }'
Respuesta Exitosa (201 Created) 
{
  "id": "ID_DEL_DOCUMENTO_GENERADO"
}
local_shipping

Genera una Nota de Remision electrónica

POST /api/electronic-document/generate-remission-note

Crea una Nota de Remisión electrónica para el traslado de mercaderías entre establecimientos.

Parámetros

user object Requerido

Objeto anidado (ApiCreateUserDto).

client object Requerido

Objeto anidado (ApiCreateClientDto).

establishment object Requerido

Objeto anidado (EstablishmentDto).

transfer object Requerido

Objeto anidado (TransferDto).

originAndDestination object Requerido

Objeto anidado (ApiOriginAndDestinationDto).

shipper object Requerido

Objeto anidado (ShipperDto).

items array Requerido

Lista de objetos (ApiCreateItemDto).

interestDescriptionOfTreasury string Requerido

Campo dInfoFisc

pointOfExpedition string Requerido

Campo dPunExp

documentNumber string Requerido

Campo dNumDoc

serieNumber string

Campo dSerieNum

cdc string

Campo opcional.

observation string

Campo dInfoEmi - Página 62 del manual técnico

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/electronic-document/generate-remission-note \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": {
      "name": "Juan",
      "lastName": "Pérez",
      "email": "cliente@empresa.com.py",
      "documentType": 1,
      "documentNumber": "",
      "position": "Gerente",
      "phone": "021123456"
    },
    "client": {
      "fantasyName": "Mi Empresa",
      "ruc": "80012345-6",
      "businessName": "Mi Empresa S.A.",
      "address": "Av. Mariscal López 1234",
      "email": "cliente@empresa.com.py",
      "email2": "contacto@empresa.com.py",
      "isContributor": false,
      "houseNumber": 0,
      "cityIdSifen": 0,
      "countryIdSifen": "",
      "contributorType": 1,
      "documentType": 1,
      "documentNumber": "",
      "phone": "021123456",
      "cellPhone": "0981123456",
      "departmentOffice": "Central",
      "addressReference": "Frente a la plaza",
      "operationType": 1
    },
    "establishment": {
      "idSifen": "001",
      "address": "Av. Mariscal López 1234",
      "houseNumber": 0,
      "cityId": 0,
      "phone": "021123456",
      "phone2": "021123457",
      "phone3": "021123458",
      "email": "cliente@empresa.com.py",
      "denomination": "Casa Matriz",
      "complementAddress1": "",
      "complementAddress2": ""
    },
    "transfer": {
      "transferMotiveType": 1,
      "transferMotiveTypeOtherDescription": "",
      "responsibleOfEmissionType": 1,
      "responsibleOfFreightType": 1,
      "shouldAssociateDocument": false,
      "futureDateOfTransfer": "2026-07-15T00:00:00.000Z",
      "referencedCdc": "",
      "modalityTransportType": 1,
      "estimatedTransferStartDate": "2026-07-15T00:00:00.000Z",
      "estimatedTransferFinishDate": "2026-07-15T00:00:00.000Z",
      "transportType": 1,
      "vehicleIdentificationType": 1,
      "vehicleType": "",
      "vehicleBrand": "",
      "vehicleIdentificationNumber": "",
      "vehicleLicensePlate": ""
    },
    "originAndDestination": {
      "originCityIdSifen": 0,
      "originAddress": "",
      "originHouseNumber": "",
      "originAddressReference": "",
      "destinationCityIdSifen": 0,
      "destinationAddress": "",
      "destinationHouseNumber": "",
      "destinationAddressReference": ""
    },
    "shipper": {
      "isContributor": false,
      "businessName": "Mi Empresa S.A.",
      "ruc": "80012345-6",
      "documentType": 1,
      "documentNumber": "",
      "driverDocumentNumber": "",
      "driverFullName": ""
    },
    "items": [
      {
        "code": "PROD001",
        "description": "Producto o servicio de ejemplo",
        "measureUnit": 0,
        "amount": 0,
        "unitPrice": 0,
        "unitDiscountPercentage": 0,
        "unitNetDiscount": 0,
        "taxPercentage": 0,
        "taxRate": 0,
        "ivaType": 1,
        "observations": "Sin observaciones"
      }
    ],
    "interestDescriptionOfTreasury": "",
    "pointOfExpedition": "001",
    "documentNumber": "0000001",
    "serieNumber": "AA",
    "cdc": "",
    "observation": "Sin observaciones"
  }'
Respuesta Exitosa (201 Created) 
{
  "id": "ID_DEL_DOCUMENTO_GENERADO"
}
undo

Genera una Nota de Crédito electrónica

POST /api/electronic-document/generate-credit-note

Crea una Nota de Crédito electrónica asociada a un documento existente.

Parámetros

cdcElectronicDocumentAttached string Requerido

Campo requerido.

user object Requerido

Objeto anidado (ApiCreateUserDto).

establishment object Requerido

Objeto anidado (EstablishmentDto).

emissionMotive number Requerido

Campo dMotEmi - Página 77 del manual técnico Valores posibles: 1, 2, 3, 4, 5, 6, 7, 8.

items array Requerido

Lista de objetos (ApiCreditOrDebitNoteItemDto).

pointOfExpedition string Requerido

Campo dPunExp

documentNumber string Requerido

Campo dNumDoc

serieNumber string

Campo dSerieNum

cdc string

Campo opcional.

observation string

Campo dInfoEmi - Página 62 del manual técnico

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/electronic-document/generate-credit-note \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cdcElectronicDocumentAttached": "",
    "user": {
      "name": "Juan",
      "lastName": "Pérez",
      "email": "cliente@empresa.com.py",
      "documentType": 1,
      "documentNumber": "",
      "position": "Gerente",
      "phone": "021123456"
    },
    "establishment": {
      "idSifen": "001",
      "address": "Av. Mariscal López 1234",
      "houseNumber": 0,
      "cityId": 0,
      "phone": "021123456",
      "phone2": "021123457",
      "phone3": "021123458",
      "email": "cliente@empresa.com.py",
      "denomination": "Casa Matriz",
      "complementAddress1": "",
      "complementAddress2": ""
    },
    "emissionMotive": 1,
    "items": [
      {
        "code": "PROD001",
        "amount": 0,
        "unitPrice": 0
      }
    ],
    "pointOfExpedition": "001",
    "documentNumber": "0000001",
    "serieNumber": "AA",
    "cdc": "",
    "observation": "Sin observaciones"
  }'
Respuesta Exitosa (201 Created) 
{
  "id": "ID_DEL_DOCUMENTO_GENERADO"
}
post_add

Genera una Nota de Débito electrónica

POST /api/electronic-document/generate-debit-note

Crea una Nota de Débito electrónica asociada a un documento existente.

Parámetros

cdcElectronicDocumentAttached string Requerido

Campo requerido.

user object Requerido

Objeto anidado (ApiCreateUserDto).

establishment object Requerido

Objeto anidado (EstablishmentDto).

emissionMotive number Requerido

Campo dMotEmi - Página 77 del manual técnico Valores posibles: 1, 2, 3, 4, 5, 6, 7, 8.

items array Requerido

Lista de objetos (ApiCreditOrDebitNoteItemDto).

pointOfExpedition string Requerido

Campo dPunExp

documentNumber string Requerido

Campo dNumDoc

serieNumber string

Campo dSerieNum

cdc string

Campo opcional.

observation string

Campo dInfoEmi - Página 62 del manual técnico

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/electronic-document/generate-debit-note \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cdcElectronicDocumentAttached": "",
    "user": {
      "name": "Juan",
      "lastName": "Pérez",
      "email": "cliente@empresa.com.py",
      "documentType": 1,
      "documentNumber": "",
      "position": "Gerente",
      "phone": "021123456"
    },
    "establishment": {
      "idSifen": "001",
      "address": "Av. Mariscal López 1234",
      "houseNumber": 0,
      "cityId": 0,
      "phone": "021123456",
      "phone2": "021123457",
      "phone3": "021123458",
      "email": "cliente@empresa.com.py",
      "denomination": "Casa Matriz",
      "complementAddress1": "",
      "complementAddress2": ""
    },
    "emissionMotive": 1,
    "items": [
      {
        "code": "PROD001",
        "amount": 0,
        "unitPrice": 0
      }
    ],
    "pointOfExpedition": "001",
    "documentNumber": "0000001",
    "serieNumber": "AA",
    "cdc": "",
    "observation": "Sin observaciones"
  }'
Respuesta Exitosa (201 Created) 
{
  "id": "ID_DEL_DOCUMENTO_GENERADO"
}
schedule_send

Genera una Factura de Anticipo electrónica

POST /api/electronic-document/generate-advance-invoice

Crea una Factura de Anticipo electrónica para registrar un pago adelantado.

Parámetros

user object Requerido

Objeto anidado (ApiCreateUserDto).

client object Requerido

Objeto anidado (ApiCreateClientDto).

establishment object Requerido

Objeto anidado (EstablishmentDto).

transactionType number Requerido

Campo iTipTra - Página 66 del manual técnico Valores posibles: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13.

operationConditionType number Requerido

Campo iCondOpe - Página 80 del manual técnico Valores posibles: 1, 2.

items array Requerido

Lista de objetos (ApiCreateAdvanceInvoiceItemDto).

paymentMethods array Requerido

Lista de objetos (ApiCreatePaymentMethodDto).

emissionType number Requerido

Campo iTipEmi - Página 62 del manual técnico Valores posibles: 1, 2.

presenceIndicatorType number Requerido

Campo iIndPres - Página 64 del manual técnico Valores posibles: 1, 2, 3, 4, 5, 6, 9.

expirationDate string Requerido

Obligatorio cuando operationConditionType = 2

pointOfExpedition string Requerido

Campo dPunExp

documentNumber string Requerido

Campo dNumDoc

serieNumber string

Campo dSerieNum

currency string Requerido

Campo cMoneOpe - Página 67 del manual técnico

currencyRate number Requerido

Campo dTiCam

cdc string

Campo opcional.

observation string

Campo dInfoEmi - Página 62 del manual técnico

interestDescriptionOfTreasury string

Campo dInfoFisc

advanceConditionType number Requerido

Campo iCondAnt - Página 68 del manual técnico Valores posibles: 1, 2.

associatedAdvanceCdc string

CDC del documento de anticipo asociado

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/electronic-document/generate-advance-invoice \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": {
      "name": "Juan",
      "lastName": "Pérez",
      "email": "cliente@empresa.com.py",
      "documentType": 1,
      "documentNumber": "",
      "position": "Gerente",
      "phone": "021123456"
    },
    "client": {
      "fantasyName": "Mi Empresa",
      "ruc": "80012345-6",
      "businessName": "Mi Empresa S.A.",
      "address": "Av. Mariscal López 1234",
      "email": "cliente@empresa.com.py",
      "email2": "contacto@empresa.com.py",
      "isContributor": false,
      "houseNumber": 0,
      "cityIdSifen": 0,
      "countryIdSifen": "",
      "contributorType": 1,
      "documentType": 1,
      "documentNumber": "",
      "phone": "021123456",
      "cellPhone": "0981123456",
      "departmentOffice": "Central",
      "addressReference": "Frente a la plaza",
      "operationType": 1
    },
    "establishment": {
      "idSifen": "001",
      "address": "Av. Mariscal López 1234",
      "houseNumber": 0,
      "cityId": 0,
      "phone": "021123456",
      "phone2": "021123457",
      "phone3": "021123458",
      "email": "cliente@empresa.com.py",
      "denomination": "Casa Matriz",
      "complementAddress1": "",
      "complementAddress2": ""
    },
    "transactionType": 1,
    "operationConditionType": 1,
    "items": [
      {
        "code": "PROD001",
        "description": "Producto o servicio de ejemplo",
        "measureUnit": 0,
        "amount": 0,
        "unitPrice": 0,
        "taxPercentage": 0,
        "taxRate": 0,
        "ivaType": 1,
        "observations": "Sin observaciones",
        "globalItemAdvance": 0,
        "particularItemAdvance": 0
      }
    ],
    "paymentMethods": [
      {
        "paymentType": 1,
        "cardType": 1,
        "formOfProccessingPayment": 1,
        "issuingEntity": "",
        "chequeNumber": "",
        "charge": 0,
        "currency": "PYG",
        "currencyRate": 7282
      }
    ],
    "emissionType": 1,
    "presenceIndicatorType": 1,
    "expirationDate": "2026-07-15T00:00:00.000Z",
    "pointOfExpedition": "001",
    "documentNumber": "0000001",
    "serieNumber": "AA",
    "currency": "PYG",
    "currencyRate": 7282,
    "cdc": "",
    "observation": "Sin observaciones",
    "interestDescriptionOfTreasury": "",
    "advanceConditionType": 1,
    "associatedAdvanceCdc": "01082292629001221100034522025091610343605356"
  }'
Respuesta Exitosa (201 Created) 
{
  "id": "ID_DEL_DOCUMENTO_GENERADO"
}
search

Consulta la informacion de un Documento electrónico

GET /api/electronic-document/{cdc}

Consulta el estado y los datos de un Documento Electrónico a partir de su CDC.

Parámetros

cdc string Requerido

CDC del Documento electrónico (parámetro de la URL)

status string

Valores posibles: APPROVED, REJECTED, IN_REVIEW, INUTILIZATION, FORWARDING, FORWARDED, CANCELED. (parámetro opcional de query string)

Ejemplo de Solicitud (cURL) 
curl -X GET https://api.goekua.com.py/api/electronic-document/CDC_DEL_DOCUMENTO \
  -H "x-api-key: TU_API_KEY"
Respuesta Exitosa (200 OK) 
{
  "status": "APPROVED",
  "cdc": "",
  "sifenAuthorization": "",
  "responseSifenCode": "",
  "responseSifenMessage": "",
  "kudeUrl": "",
  "xml": ""
}
badge

Consulta de ruc

GET /api/ruc/{ruc}

Consulta los datos de un contribuyente paraguayo a partir de su RUC.

Parámetros

ruc string Requerido

Parámetro de la solicitud. (parámetro de la URL)

Ejemplo de Solicitud (cURL) 
curl -X GET https://api.goekua.com.py/api/ruc/80012345-6 \
  -H "x-api-key: TU_API_KEY"
Respuesta Exitosa (200 OK) 
{
  "id": 0,
  "code": "PROD001",
  "message": "",
  "ruc": "80012345-6",
  "bussinesName": "",
  "isElectronicInvoicingSystem": "",
  "status": ""
}
upload_file

Subir un certificado

POST /api/certificate/upload

Sube el certificado digital (.p12/.pfx) que se usa para firmar los documentos electrónicos.

Parámetros

file object Requerido

Campo requerido.

password string Requerido

Campo requerido.

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/certificate/upload \
  -H "x-api-key: TU_API_KEY" \
  -F "file=@/ruta/a/certificado.p12" \
  -F "password=TU_CONTRASENA"
Respuesta Exitosa (201 Created) 
{
  "message": "El certificado ha sido subido correctamente"
}
verified_user

Consulta tu certificado subido

GET /api/certificate

Consulta los datos del certificado digital actualmente subido para tu cuenta.

Ejemplo de Solicitud (cURL) 
curl -X GET https://api.goekua.com.py/api/certificate \
  -H "x-api-key: TU_API_KEY"
Respuesta Exitosa (200 OK) 
{
  "expirationDate": "2026-07-15T00:00:00.000Z",
  "certificateName": ""
}
block

Genera una inutilizacion de un documento electronico

POST /api/generate-inutilization-electronic-document/{cdc}

Inutiliza un número de timbrado/documento que no llegó a usarse, informándolo a la SET.

Parámetros

cdc string Requerido

CDC del Documento electrónico (parámetro de la URL)

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/generate-inutilization-electronic-document/CDC_DEL_DOCUMENTO \
  -H "x-api-key: TU_API_KEY"
Respuesta Exitosa (200 OK) 
{
  "responseSifenCode": "",
  "responseSifenMessage": "",
  "responseSifenAuthorization": ""
}
send

Reenvia un documento electronico

POST /api/forwarding-electronic-document/{cdc}

Reenvía a la SET/SIFEN un documento electrónico que quedó pendiente de procesamiento.

Parámetros

cdc string Requerido

CDC del Documento electrónico (parámetro de la URL)

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/forwarding-electronic-document/CDC_DEL_DOCUMENTO \
  -H "x-api-key: TU_API_KEY"
Respuesta Exitosa (200 OK) 
{
  "message": "Documento electrónico enviado correctamente"
}
cancel

Genera una anulación de un documento electronico

POST /api/generate-cancellation-electronic-document/{cdc}

Genera el evento de cancelación de un documento electrónico ya aprobado.

Parámetros

cdc string Requerido

CDC del Documento electrónico (parámetro de la URL)

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/generate-cancellation-electronic-document/CDC_DEL_DOCUMENTO \
  -H "x-api-key: TU_API_KEY"
Respuesta Exitosa (200 OK) 
{
  "message": "Documento electrónico cancelado correctamente"
}
person_add

Genera el evento de Nominación del Receptor (SIFEN evento 15)

POST /api/generate-nomination-electronic-document/{cdc}

Registra el evento de Nominación del Receptor (evento SIFEN 15) para asociar un receptor a un documento.

Parámetros

cdc string Requerido

CDC del Documento electrónico (parámetro de la URL)

reason string Requerido

Motivo del evento de Nominación (GENFE003). Texto libre.

isContributor boolean Requerido

Naturaleza del receptor (GENFE004). true=contribuyente, false=no contribuyente.

operationType number Requerido

Tipo de operación (GENFE027). 1=B2B, 2=B2C, 4=B2F. Valores posibles: 1, 2, 4.

countryIdSifen string Requerido

Código ISO-3 del país del receptor (GENFE005). Para B2F debe ser distinto de PRY; para B2B/B2C debe ser PRY.

businessName string Requerido

Nombre o razón social del receptor (GENFE013).

ruc string

RUC del receptor con dígito verificador (GENFE008-GENFE009). Obligatorio si isContributor=true. Formato "NNNNNNNN-D".

contributorType number

Tipo de contribuyente receptor (GENFE007). 1=Persona Física, 2=Persona Jurídica. Obligatorio si isContributor=true. Valores posibles: 1, 2.

documentType number

Tipo de documento de identidad del receptor (GENFE010). Obligatorio si isContributor=false. NOTA NT-027 (vigente 2026-03-09): "Tarjeta Diplomática" pasa del código 5 al 6 cuando entre la nueva nota. Valores posibles: 1, 2, 3, 4, 5, 6, 9.

documentTypeDescription string

Descripción libre del tipo de documento cuando documentType=9/OTHER (GENFE011).

documentNumber string

Número de documento de identidad del receptor (GENFE012). Obligatorio si isContributor=false.

fantasyName string

Nombre de fantasía (GENFE014).

address string Requerido

Dirección del receptor (GENFE015).

houseNumber number Requerido

Número de casa (GENFE016). Numérico, hasta 6 dígitos (máx 999999). Obligatorio porque siempre se informa address.

departmentIdSifen number

Código sifen del departamento (GENFE017). Si no se envía y operationType != 4, se deriva automáticamente desde la jerarquía de cityIdSifen.

districtIdSifen number

Código sifen del distrito (GENFE019). Si no se envía y operationType != 4, se deriva automáticamente desde la jerarquía de cityIdSifen.

cityIdSifen number

Código sifen de la ciudad (GENFE021). Obligatorio cuando operationType != 4 (B2B/B2C); no se informa para B2F.

phone string

Teléfono fijo (GENFE023).

cellPhone string

Celular (GENFE024).

email string Requerido

Email del receptor (GENFE025).

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/generate-nomination-electronic-document/CDC_DEL_DOCUMENTO \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Se asigna el receptor correcto del DTE",
    "isContributor": false,
    "operationType": 1,
    "countryIdSifen": "PRY",
    "businessName": "Mi Empresa S.A.",
    "ruc": "80012345-6",
    "contributorType": 1,
    "documentType": 1,
    "documentTypeDescription": "",
    "documentNumber": "",
    "fantasyName": "Mi Empresa",
    "address": "Av. Mariscal López 1234",
    "houseNumber": 1234,
    "departmentIdSifen": 0,
    "districtIdSifen": 0,
    "cityIdSifen": 0,
    "phone": "021123456",
    "cellPhone": "0981123456",
    "email": "cliente@empresa.com.py"
  }'
Respuesta Exitosa (200 OK) 
{
  "message": "Evento de Nominación registrado."
}
fact_check

Consulta documentos en el SET

GET /api/consulta-documentos-set/{cdc}

Consulta directamente en el SET (DNIT) el estado de un documento electrónico por su CDC.

Parámetros

cdc string Requerido

Parámetro de la solicitud. (parámetro de la URL)

Ejemplo de Solicitud (cURL) 
curl -X GET https://api.goekua.com.py/api/consulta-documentos-set/CDC_DEL_DOCUMENTO \
  -H "x-api-key: TU_API_KEY"
Respuesta Exitosa (200 OK) 
{
  "message": "OK"
}
code

Obtiene un XML transformado a JSON

GET /api/get-xml-json/{cdc}

Devuelve el XML del documento electrónico transformado a formato JSON.

Parámetros

cdc string Requerido

Parámetro de la solicitud. (parámetro de la URL)

Ejemplo de Solicitud (cURL) 
curl -X GET https://api.goekua.com.py/api/get-xml-json/CDC_DEL_DOCUMENTO \
  -H "x-api-key: TU_API_KEY"
Respuesta Exitosa (200 OK) 
{
  "rDE": {
    "DE": {
      "dFecFirma": "2024-11-22",
      "gDatGralOpe": {
        "dFeEmiDE": "2024-11-22",
        "gOpeCom": {
          "iTImp": "01",
          "dDesTImp": "IVA",
          "cMoneOpe": "USD",
          "dDesMoneOpe": "Dólares"
        },
        "gEmis": {
          "dRucEm": "123456789",
          "dDVEmi": "01",
          "iTipCont": "1",
          "cTipReg": "A",
          "dNomEmi": "Juan Pérez",
          "dNomFanEmi": "J&P S.A.",
          "dDirEmi": "Av. Siempre Viva 123",
          "dNumCas": "456",
          "dCompDir1": "Frente a la plaza principal",
          "cDepEmi": "12",
          "dDesDepEmi": "Departamento de Comercio",
          "cDisEmi": "01",
          "dDesDisEmi": "Distrito 1",
          "cCiuEmi": "0001",
          "dDesCiuEmi": "Ciudad A",
          "dTelEmi": "123-4567890",
          "dEmailE": "email@empresa.com",
          "dDenSuc": "Sucursal Central",
          "gActEco": {
            "cActEco": null,
            "dDesActEco": null
          },
          "gRespDE": {
            "iTipIDRespDE": null,
            "dDTipIDRespDE": null,
            "dNumIDRespDE": null,
            "dNomRespDE": null,
            "dCarRespDE": null
          }
        },
        "gDatRec": {
          "iNatRec": "01",
          "iTiOpe": "Venta",
          "cPaisRec": "PE",
          "dDesPaisRe": "Perú",
          "iTiContRec": "1",
          "dRucRec": "123456789",
          "dDVRec": "01",
          "dNomRec": "Cliente S.A.",
          "dNomFanRec": "Cliente S.A.",
          "dDirRec": "Calle Falsa 456",
          "dNumCasRec": "789",
          "cDepRec": "01",
          "dDesDepRec": "Lima",
          "cDisRec": "01",
          "dDesDisRec": "Centro",
          "cCiuRec": "01",
          "dDesCiuRec": "Lima",
          "dTelRec": "987-654321",
          "dCelRec": "987-654321",
          "dEmailRec": "cliente@empresa.com",
          "dCodCliente": "C123456"
        }
      },
      "gTimb": {
        "iTiDE": "01",
        "dDesTiDE": "Factura Electrónica",
        "dNumTim": "12345",
        "dEst": "01",
        "dPunExp": "01",
        "dNumDoc": "001",
        "dSerieNum": "A",
        "dFeIniT": "2024-11-22"
      },
      "gDtipDE": {
        "gCamItem": [
          {
            "dCodInt": null,
            "dDesProSer": null,
            "cUniMed": null,
            "dDesUniMed": null,
            "dCantProSer": null,
            "gValorItem": null,
            "gCamIVA": null
          }
        ]
      },
      "gTotSub": {
        "dSubExe": "150",
        "dSubExo": "0",
        "dSub5": "0",
        "dSub10": "0",
        "dTotOpe": "3000",
        "dTotIVA": "272.727273",
        "dBaseExe": "0",
        "dBaseGrav5": "0",
        "dBaseGrav10": "0"
      }
    }
  }
}
payments

Genera un recibo de dinero

POST /api/generate-receipt-payment

Genera un recibo de dinero por el pago parcial o total de un documento electrónico.

Parámetros

cdc string Requerido

Código de Control (CDC)

datePayment string Requerido

Fecha del pago en formato ISO (YYYY-MM-DD)

paymentMethod number Requerido

Método de pago utilizado. Valores posibles: 1 (Efectivo), 3 (Tarjeta de crédito), 4 (Tarjeta de débito), 5 (Transferencia bancaria), 2 (Cheque), 22 (Descuento), 23 (Incobrable).

amount number Requerido

Monto del pago

observation string

Observaciones del pago

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/generate-receipt-payment \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cdc": "01800268520001001000000422024082310845861483",
    "datePayment": "2025-01-01",
    "paymentMethod": 1,
    "amount": "10000",
    "observation": "Sin observaciones"
  }'
Respuesta Exitosa (201 Created) 
{
  "status": 200,
  "message": "Pago parcial exitoso",
  "receiptNumber": "0000642",
  "url": "https://goekua/pago_recibo.pdf"
}
receipt

Consulta los recibos de dineros asociados a un CDC

GET /api/get-receipt-payment/{cdc}

Consulta los recibos de dinero asociados a un documento electrónico (CDC).

Parámetros

cdc string Requerido

Parámetro de la solicitud. (parámetro de la URL)

Ejemplo de Solicitud (cURL) 
curl -X GET https://api.goekua.com.py/api/get-receipt-payment/CDC_DEL_DOCUMENTO \
  -H "x-api-key: TU_API_KEY"
Respuesta Exitosa (200 OK) 
{
  "cdc": "01800268520001001000000422024082310845861483",
  "partialPayments": [
    {
      "amount": 150000,
      "datePayment": "2025-01-14",
      "receiptNumber": "000456",
      "voided": false,
      "paymentMethod": 1,
      "observation": "Pago inicial",
      "url": "https://goekua.com/receipt/12345"
    }
  ]
}
money_off

Anula un recibo de dinero asociado a un CDC

POST /api/void-receipt-payment/{cdc}

Anula un recibo de dinero previamente generado para un documento electrónico.

Parámetros

cdc string Requerido

Código de control del documento electrónico (parámetro de la URL)

receiptPaymentNumber string Requerido

Número del recibo de dinero

Ejemplo de Solicitud (cURL) 
curl -X POST https://api.goekua.com.py/api/void-receipt-payment/CDC_DEL_DOCUMENTO \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "receiptPaymentNumber": "123456789"
  }'
Respuesta Exitosa (200 OK) 
{
  "message": "Recibo de dinero anulado correctamente"
}
edit

Actualiza datos de un cliente

PATCH /api/update-client

Actualiza los datos de un cliente ya registrado, identificado por RUC o número de documento.

Parámetros

clientDocumentOrRuc string Requerido

ruc o documentNumber del cliente registrado

isContributor boolean

Campo opcional.

documentNumber string

Obligatorio cuando isContributor = false

ruc string

Obligatorio cuando isContributor = true

contributorType number

Campo iTiContRec - Página 71 del manual técnico, Obligatorio cuando isContributor = true Valores posibles: 1, 2.

operationType number

Campo iTiOpe - Página 71 del manual técnico Valores posibles: 1, 2, 3, 4.

documentType number

Campo iTipIDRec - Página 71 del manual técnico, Obligatorio cuando isContributor = false Valores posibles: 1, 2, 3, 4, 5, 6, 9.

businessName string

Campo opcional.

fantasyName string

Campo opcional.

email string

Campo opcional.

email2 string

Campo opcional.

address string

Campo opcional.

houseNumber number

Campo opcional.

cityIdSifen number

Según Tabla 2.1 – Departamentos, Distritos Y Ciudades - [Página 210 del manual técnico](https://ekuatia.set.gov.py/portal/ekuatia/detail?content-id=/repository/collaboration/sites/ekuatia/documents/documentacion/documentacion-tecnica/CODIGO%20DE%20REFERENCIA%20GEOGRAFICA.xlsx)(Columna F correspondiente al código de la Ciudad)

countryIdSifen string

Según Tabla 4 - Codificacion de paises - Página 211 del manual técnico

phone string

Campo opcional.

cellPhone string

Campo opcional.

departmentOffice string

Campo opcional.

addressReference string

Campo opcional.

Ejemplo de Solicitud (cURL) 
curl -X PATCH https://api.goekua.com.py/api/update-client \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clientDocumentOrRuc": "80012345-6",
    "isContributor": false,
    "documentNumber": "",
    "ruc": "80012345-6",
    "contributorType": 1,
    "operationType": 1,
    "documentType": 1,
    "businessName": "Mi Empresa S.A.",
    "fantasyName": "Mi Empresa",
    "email": "cliente@empresa.com.py",
    "email2": "contacto@empresa.com.py",
    "address": "Av. Mariscal López 1234",
    "houseNumber": 0,
    "cityIdSifen": 0,
    "countryIdSifen": "",
    "phone": "021123456",
    "cellPhone": "0981123456",
    "departmentOffice": "Central",
    "addressReference": "Frente a la plaza"
  }'
Respuesta Exitosa (200 OK) 
{
  "status": 200,
  "message": "Cliente actualizado correctamente",
  "data": {
    "clientFound": {
      "clientDocumentOrRuc": "123456789",
      "businessName": "Víctor Ramírez",
      "ruc": null,
      "documentNumber": "123456789",
      "isContributor": false
    },
    "fieldsUpdated": {
      "businessName": "Victor Hugo Ramírez Peralta"
    }
  }
}