Empresas

Cuenta, empresa y ambiente

Una cuenta es tu cliente de foliios. Tiene personas con roles, claves y una o más empresas.
Una empresa emisora es quien factura: el obligado a facturar ante la DIAN. Tiene un identificador propio de foliios, company_id (empieza por cmp_). No es el NIT: el NIT es un dato personal y no viaja en las URL.
Una empresa tiene un conjunto de datos por ambiente. Los documentos, la numeración, las resoluciones y la configuración de sandbox, test y live nunca se mezclan.
Una clave puede alcanzar varias empresas de la cuenta. Las rutas de la API llevan el company_id, y la verificación de integración y las demás lecturas se hacen por empresa.

Una empresa que tu clave no alcanza (de otra cuenta, inexistente o no concedida) responde 404 not_found, idéntico al de un documento que no existe: la API no revela si existe.

Qué se configura en el portal

Las empresas, las resoluciones y los certificados se crean en el portal, no por la API:

Qué	Para qué sirve
Datos del emisor	Identificación, régimen, responsabilidades, dirección, establecimientos y correo de recepción. Son los mismos en habilitación y en producción.
Software	El software registrado ante la DIAN (`SoftwareID`, PIN y, en habilitación, `TestSetId`).
Resoluciones	Los rangos de numeración autorizados por la DIAN. Ver numeración y series.
Certificado	El `.p12` con el que se firman los documentos de la empresa.
Claves y conexiones de agente	Ver ambientes y claves.
Webhooks	El endpoint al que foliios avisa de los cambios. Ver webhooks.

La empresa del sandbox

Al entrar por primera vez al ambiente Sandbox, foliios crea una empresa de prueba y configura el sandbox de cada empresa de tu cuenta con su propia resolución, software y certificado de prueba. No hay formulario: en el sandbox no se puede guardar a mano el software, las resoluciones ni el certificado. La empresa de prueba solo existe en el sandbox.

Puedes reiniciar el sandbox de una empresa desde el portal: borra sus documentos, entregas, borradores y el buzón, y conserva la configuración, las claves y la cuota del mes. Escribes el identificador de la empresa para confirmar.