Clientes

Los clientes en Solerba representan a los receptores de las facturas electrónicas. Cada cliente tiene datos fiscales asociados que determinan cómo se genera la factura ante la DGI.

Tipos de receptor

La DGI de Panamá clasifica a los receptores de facturas en cuatro tipos:

Código	Tipo	Descripción
01	Contribuyente	Persona natural o jurídica registrada ante la DGI con RUC
02	Consumidor Final	Persona que adquiere bienes o servicios para uso personal
03	Gobierno	Entidades gubernamentales
04	Extranjero	Personas o empresas no registradas en Panamá

Datos requeridos por tipo de receptor

Los datos fiscales requeridos varían según el tipo de receptor:

Campo	Contribuyente (01)	Consumidor Final (02)	Gobierno (03)	Extranjero (04)
taxName	Requerido	Opcional	Requerido	Requerido
taxId (RUC)	Requerido	No aplica	Requerido	Requerido
taxDv (DV)	Requerido	No aplica	Requerido	Requerido
taxIdType	Requerido (1 o 2)	No aplica	Requerido	Requerido
email	Requerido	Opcional	Requerido	Requerido
phone	Opcional	Opcional	Opcional	Opcional
dni	No aplica	Opcional	No aplica	No aplica

Tipo de identificación (taxIdType)

• 1 — Persona natural (cédula)
• 2 — Persona jurídica (RUC empresarial)

Consumidor Final

El caso más simple de facturación. Cuando no se envía el objeto client en la API, la factura se emite automáticamente como Consumidor Final (tipo 02).

Para Consumidor Final:

• No se requiere RUC ni datos fiscales
• Opcionalmente se puede incluir un dni (cédula) para identificación
• El email es opcional

Contribuyente

Para facturar a un contribuyente, es necesario proporcionar datos fiscales completos:

{
  "client": {
    "taxName": "Empresa ABC S.A.",
    "taxId": "6-123-3123",
    "taxDv": 1,
    "taxIdType": 2,
    "taxReceiverType": "01",
    "email": "[email protected]"
  }
}

Validación de RUC

Puedes validar los datos fiscales de un RUC antes de facturar usando el endpoint .

Clientes en las facturas por API

Los datos del cliente que envías en una factura por API (client) se usan únicamente para emitir el documento fiscal: no crean ni modifican clientes en el catálogo de la empresa. El catálogo se gestiona desde el panel.

Esto significa que no necesitas registrar al cliente en Solerba antes de facturarle — basta con enviar sus datos fiscales completos en cada factura. Ver los campos disponibles en .

Gestión desde el panel

Desde el panel de administración y el panel de facturación puedes:

• Ver el listado de clientes registrados por empresa
• Crear nuevos clientes con sus datos fiscales
• Editar información de clientes existentes

Siguientes pasos

• — Emite facturas a tus clientes
• — Referencia del endpoint con ejemplos por tipo de receptor
• — Valida datos fiscales antes de facturar