Ambientes y datos de prueba
Colfact dispone de un ambiente de Demo para que los equipos de desarrollo puedan realizar pruebas de integración, validar el envío de documentos electrónicos y verificar las respuestas del servicio antes de utilizar el ambiente de producción.
Ambiente disponible
🧪 Ambiente Demo
Servicio web
https://micro.conexusit.com/corp/demo/api/Service.svc
Documentación Swagger
Utilice exclusivamente las URL del ambiente Demo durante las pruebas de integración. No envíe información de prueba a los servicios de producción.
Configuración de la integración
Para consumir los servicios de Colfact, se requiere configurar los datos de seguridad, la identificación del sistema integrado y la información del emisor y de sus autorizaciones.
1. Datos de seguridad e integración
Los siguientes identificadores y parámetros deben ser suministrados por el equipo de desarrollo de Colfact, de acuerdo con la configuración asignada a la organización en el ambiente Demo.
| Parámetro | Descripción |
|---|---|
GuidEmpresa | Identificador de la empresa en Colfact. |
GuidOrigen | Identificador del origen de las solicitudes. |
HashSeguridad | Valor de seguridad requerido para la autenticación. |
GuidSistemaIntegrado | Identificador del sistema integrado registrado en Colfact. |
También puede obtener GuidEmpresa, GuidOrigen y HashSeguridad registrando el emisor con el método RegistroEmisor.
Solicite al equipo de desarrollo de Colfact los GUID y los parámetros de seguridad correspondientes al ambiente Demo. Estos valores dependen de la configuración asignada a cada integración y no deben asumirse ni reutilizarse entre organizaciones.
2. Datos del emisor
Una vez registrada y configurada la organización en el ambiente Demo, el equipo de desarrollo de Colfact proporcionará los datos del emisor que se deben utilizar en las pruebas.
Entre los datos que pueden requerirse se encuentran:
| Parámetro | Descripción |
|---|---|
EmiTipoPersona | Código del tipo de persona del emisor. |
EmiTipoIdentificacion | Código del tipo de identificación del emisor. |
EmiIdentificacion | Número de identificación del emisor. |
EmiDVIdentificacion | Dígito de verificación del número de identificación. |
3. Autorizaciones de numeración
Para realizar pruebas de emisión, se debe contar con la información de numeración correspondiente al tipo de documento que se desea procesar.
El equipo de desarrollo de Colfact debe confirmar los parámetros aplicables a la configuración del emisor, incluyendo los prefijos y rangos de numeración que correspondan.
Para la facturación electrónica, los documentos soporte, facturación POS, según corresponda, se deben verificar los siguientes datos:
| Parámetro | Descripción |
|---|---|
AutNumAutorizacion | Número de autorización de numeración. |
AutFechaInicio | Fecha inicial de vigencia de la autorización. |
AutFechaFinal | Fecha final de vigencia de la autorización. |
AutPrefijo | Prefijo autorizado para la numeración. |
AutSecuenciaInicio | Consecutivo inicial autorizado. |
AutSecuenciaFinal | Consecutivo final autorizado. |
ClaveTecnica | Clave técnica asociada a la autorización. |
Los prefijos, rangos de numeración, fechas de vigencia y claves técnicas deben corresponder a la autorización configurada para el emisor y al tipo de documento que se desea probar. No utilice valores de ejemplo sin confirmarlos previamente.
Los requisitos pueden variar según el documento electrónico, por ejemplo, factura electrónica de venta, documento soporte o documento equivalente electrónico POS. Confirme los parámetros requeridos con el equipo de desarrollo de Colfact antes de iniciar las pruebas.
Solicitud de habilitación del ambiente Demo
Antes de iniciar las pruebas de integración, siga estos pasos para garantizar que su organización y su sistema estén correctamente configurados en Colfact.
-
Solicitar la habilitación
Contacte al equipo de desarrollo de Colfact para solicitar la habilitación de su organización en el ambiente Demo.
-
Proporcionar la información de la integración
Entregue la información de identificación de la organización y del sistema que se integrará, de acuerdo con el procedimiento establecido por Colfact.
-
Solicitar los datos de configuración
Solicite al equipo de desarrollo los siguientes datos requeridos para la integración:
- GUID de la empresa, del origen y del sistema integrado.
- Parámetros de seguridad requeridos para la autenticación.
- Datos de configuración del emisor.
- Información de las autorizaciones y los rangos de numeración aplicables.
-
Configurar y ejecutar las pruebas
Configure su aplicación con las URL del ambiente Demo y realice pruebas de envío y consulta de documentos electrónicos para validar el funcionamiento de la integración.
Mantenga los parámetros de conexión y seguridad en archivos de configuración o variables de entorno.