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:

json

{
  "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 .

Creación automática desde la API

Al enviar datos de un cliente en una factura por API, el sistema puede crear automáticamente el cliente en el catálogo de la empresa. Para evitar esto, usa el campo ignoreCreate: true:

json

{
  "client": {
    "ignoreCreate": true,
    "taxName": "Empresa XYZ",
    "taxId": "8-456-789",
    "taxDv": 3,
    "taxIdType": 2,
    "taxReceiverType": "01",
    "email": "[email protected]"
  }
}

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

Clientes ​

Tipos de receptor ​

Datos requeridos por tipo de receptor ​

Consumidor Final ​

Contribuyente ​

Creación automática desde la API ​

Gestión desde el panel ​

Siguientes pasos ​