Empresas y Sucursales
En Solerba, una empresa representa una entidad fiscal registrada ante la DGI de Panamá. Cada empresa puede tener múltiples sucursales desde las cuales se emiten facturas.
Empresas
¿Qué es una empresa en Solerba?
Una empresa es la unidad principal de facturación. Contiene los datos fiscales necesarios para emitir facturas electrónicas válidas ante la DGI.
Datos fiscales requeridos
| Campo | Descripción | Ejemplo |
|---|---|---|
| Nombre | Razón social de la empresa | Mi Empresa S.A. |
| Alias | Nombre corto para identificación | MiEmpresa |
| RUC | Registro Único de Contribuyente | 6-123-3123 |
| DV | Dígito Verificador | 1 |
| Tipo de contribuyente | Persona natural o jurídica | juridico |
| Teléfono | Número de contacto | +50712345678 |
| Correo electrónico de la empresa |
Configuración adicional
Cada empresa puede personalizar su experiencia de facturación:
- Colores: Color primario para personalización del PDF de la factura
- Logo: Imagen de la empresa que aparece en los documentos
- Emails:
- TOS: Términos y condiciones que aparecen en las facturas
- BCC: Correo electrónico para recibir copia de todas las facturas emitidas
Credenciales de facturación
Para que una empresa pueda emitir facturas electrónicas, es necesario configurar las credenciales del proveedor de facturación autorizado (PAC). Estas credenciales se obtienen al registrar la empresa ante el proveedor.
Configuración previa
Antes de registrar una empresa en Solerba, debes registrarla primero ante el proveedor de facturación autorizado y obtener las credenciales. Contacta al equipo de soporte para más información sobre este proceso.
API Token
Cada empresa puede generar un API Token para integraciones externas. Este token se usa en el header X-SOLERBA-TOKEN para autenticar las solicitudes a la API externa.
- Los tokens tienen una vigencia de 120 días
- Solo puede existir un token activo por empresa a la vez
- Al generar un nuevo token, el anterior se invalida
Para más detalles, consulta la .
Sucursales
¿Qué es una sucursal?
Una sucursal representa una ubicación física desde la cual la empresa emite facturas. Cada factura está asociada a una sucursal específica a través del campo branchId en la API.
Datos de una sucursal
| Campo | Descripción | Ejemplo |
|---|---|---|
| Nombre | Nombre de la sucursal | Sucursal Centro |
| Dirección | Dirección física | Calle Principal 123 |
| Ciudad | Ciudad donde se ubica | Panamá |
| Distrito | Distrito | San Felipe |
| Provincia | Provincia o estado | Panamá |
| Codubi | Código geográfico único | 4-1-2 |
| Latitud | Coordenada de latitud | 8.9824 |
| Longitud | Coordenada de longitud | -79.5199 |
| Estado | Activa o inactiva | Activa |
Código geográfico (Codubi)
El codubi es un código que identifica la ubicación geográfica de la sucursal según la clasificación de la DGI. Cada sucursal también tiene un código único asignado por el proveedor de facturación que se usa internamente en el proceso de emisión.
Gestión de sucursales
Desde el panel de administración puedes:
- Crear nuevas sucursales para una empresa
- Editar los datos de sucursales existentes
- Activar/desactivar sucursales según sea necesario
Sucursal y facturación
Al emitir una factura por API, el campo branchId es obligatorio. Asegúrate de usar el ID de una sucursal activa que pertenezca a la empresa del token.
Siguientes pasos
- — Asigna vendedores a tus empresas
- — Gestiona el catálogo de clientes fiscales
- — Asigna paquetes de folios a tus empresas