Tipos de Cuenta por Cobrar

Requisitos previos de acceso

• Permiso (módulo): creditConfigManage (para crear/editar). Lectura habilitada por viewCredits.
• Licencia/Feature: CREDIT_INVESTMENTS habilitada en la licencia del tenant (Vault).
• Contenedor del menú: TOKENIZACIÓN → grupo Crédito Tokenizado

Qué es / cuándo usar

El Tipo de Cuenta por Cobrar define las categorías de cuentas por cobrar que la plataforma acepta (duplicata, nota fiscal, tarjeta, etc.) y qué campos son obligatorios al registrar una cuenta por cobrar de ese tipo. Es lo que estandariza y valida la entrada de datos del originador.

Use esta pantalla para crear/mantener los tipos disponibles y controlar, por tipo, qué información el originador está obligado a proporcionar.

Requisitos previos

• Permiso: creditConfigManage (permiso doble — enum CPM + módulo dinámico en la BD).
• Licencia/Feature: CREDIT_INVESTMENTS habilitada.
• Dependencias: ninguna. Los tipos son consumidos después en la creación de cuentas por cobrar.

Paso a paso

1. Acceda a Crédito Tokenizado → Tipos de Cuenta por Cobrar.
2. Filtre por Activo si es necesario.
3. Haga clic en Crear.
4. Complete Código y Nombre.
5. En el bloque de campos obligatorios, haga clic en Agregar campo y elija entre los disponibles: external_reference, invoice_number, invoice_key, debtor_id, issue_date, due_date, gross_amount, net_amount, currency.
6. Haga clic en Guardar.

Campos

Campo	Qué es	¿Obligatorio?	Efecto en el sistema/backend
Código	Identificador corto/único del tipo (ej.: DUPLICATA)	Sí	Almacenado en code; usado como clave de referencia del tipo.
Nombre	Nombre amigable del tipo	Sí	Almacenado en name; aparece en el listado y en los selectores.
Campos obligatorios	Lista de los campos que el originador debe informar para ese tipo	No	Almacenado en requiredFields (array). Cada ítem elegido se convierte en un requisito de llenado al registrar una cuenta por cobrar de ese tipo.
Activo	Activa/desactiva el tipo	Sí (default Sí)	Almacenado en active; los tipos inactivos no deben ofrecerse en nuevos registros.

La pantalla tolera tanto el formato JSON como el formato de array de PostgreSQL ({invoice_number,invoice_key}) al reabrir un tipo para edición — no es necesario preocuparse por la serialización.

Acciones y modales

• Crear / Actualizar: guarda el tipo mediante createReceivableType / updateReceivableType. Botón visible solo con creditConfigManage.
• Agregar / Eliminar campo obligatorio: manipulan la lista requiredFields.
• Editar (ícono lápiz): carga el tipo y reconstruye la lista de campos obligatorios.

Por ser configuración estructural del crédito, guardar puede requerir step-up (contraseña + MFA) según el entorno.

Reglas de negocio / consideraciones

Atención

• Los campos obligatorios se convierten en validación en el origen. Marcar invoice_key como obligatorio, por ejemplo, impide el registro de una cuenta por cobrar de ese tipo sin la clave de la NFe — alinee el requisito con lo que el originador realmente puede proporcionar.
• El código debe ser estable. Como code es la clave de referencia del tipo, evite modificarlo después de que ya existan cuentas por cobrar vinculadas.
• Desactive en lugar de eliminar. Use Activo = No para discontinuar un tipo sin romper las cuentas por cobrar históricas.

Pantallas relacionadas

• Políticas de Crédito — campos como hasInvoiceValidation se conectan al requisito de NFe.
• Plantillas de Precios
• Guía de Crédito
• Crédito Tokenizado (índice del grupo)