Registrar un emisor

El método RegistroEmisor permite registrar en la plataforma los datos necesarios para crear un emisor en el ambiente de demostración. Como resultado devuelve los identificadores de integración del emisor (GuidEmpresa, GuidOrigen y HashSeguridad), que se usan después en los demás métodos de la API.

POST https://micro.conexusit.com/corp/demo/api/Service.svc/RegistroEmisor

Endpoint

Dato	Valor
Método HTTP	POST
Operación	RegistroEmisor

Requisito previo

Por seguridad, el método exige una contraseña en el encabezado password de la solicitud.

Contraseña de acceso

La contraseña no se publica en esta documentación. Solicítela al equipo de TI de Conexus IT antes de consumir el método y guárdela en un archivo de configuración o en una variable de entorno, nunca en el código fuente.

Parámetros de entrada

Encabezados

Encabezado	Tipo	Obligatorio	Descripción
password	string	Sí	Contraseña de seguridad para acceder al método. Solicítela al equipo de TI.
Content-Type	string	Sí	Debe ser application/json.

Cuerpo de la solicitud

Los datos del emisor se envían dentro de un objeto solicitud.

Campo	Descripción	Obligatorio	Observaciones
TipoPersona	Tipo de persona del emisor.	Sí	Ver lista
TipoIdentificador	Tipo de identificación del emisor.	Sí	Debe ser siempre el valor 31.
Identificador	Número de identificación del emisor.	Sí
DvIdentificador	Dígito de verificación del emisor.	Sí
RazonSocial	Razón social del emisor.	Sí
NombreComercial	Nombre comercial del emisor.	Sí
TipoRegimen	Tipo de régimen del emisor.	Sí	Ver lista
ObligFiscales	Obligación fiscal del emisor.	Sí	Ver lista
CodImpuesto	Detalle tributario del emisor.	Sí	Ver lista
Departamento	Departamento de residencia del emisor.	Sí
CodigoDepartamento	Código del departamento del emisor.	Sí	Ver tabla de códigos DANE.
Ciudad	Ciudad de residencia del emisor.	Sí
CodigoCiudad	Código de la ciudad del emisor.	Sí	Ver tabla de códigos DANE.
Sector	Sector o barrio del emisor.	Sí
Direccion	Dirección de residencia del emisor.	Sí
NombreContacto	Nombre de la persona de contacto del emisor.	Sí
TelefonoContacto	Teléfono de contacto del emisor.	Sí
CorreoElecContacto	Correo electrónico del emisor.	Sí

Ejemplo de solicitud

Encabezados

password: <contraseña suministrada por el equipo de TI>
Content-Type: application/json

Cuerpo (JSON)

{
  "solicitud": {
    "TipoPersona": "1",
    "TipoIdentificador": "31",
    "Identificador": "123456789",
    "DvIdentificador": "5",
    "RazonSocial": "Empresa XYZ",
    "NombreComercial": "Comercial XYZ",
    "TipoRegimen": "48",
    "ObligFiscales": "O-13",
    "CodImpuesto": "01",
    "Departamento": "Bogotá",
    "CodigoDepartamento": "11",
    "Ciudad": "Bogotá",
    "CodigoCiudad": "11001",
    "Sector": "Centro",
    "Direccion": "Calle 123 #45-67",
    "NombreContacto": "Juan Pérez",
    "TelefonoContacto": "3214567890",
    "CorreoElecContacto": "juanperez@example.com"
  }
}

Estructura de la respuesta

Ejemplo de respuesta exitosa (200 OK)

{
  "RegistroEmisorResult": {
    "Estado": "REGISTRADO",
    "DetalleEstado": "El Emisor fue registrado con exito, pero aun no se ha asignado ningun contrato ni certificado valido.",
    "GuidEmpresa": "<GUID de la empresa>",
    "GuidOrigen": "<GUID del origen>",
    "HashSeguridad": "<hash de seguridad>",
    "Identificador": "123456789",
    "RazonSocial": "Empresa XYZ",
    "fechaHoraSolicitud": "2025-03-17T12:12:03.8982176-05:00"
  }
}

Campos de la respuesta

Campo	Descripción
Estado	Estado del registro. Por ejemplo, REGISTRADO.
DetalleEstado	Mensaje descriptivo del resultado del registro.
GuidEmpresa	Identificador de la empresa (emisor) en Colfact.
GuidOrigen	Identificador del origen de las solicitudes.
HashSeguridad	Valor de seguridad requerido para la autenticación.
Identificador	Número de identificación del emisor registrado.
RazonSocial	Razón social del emisor registrado.
fechaHoraSolicitud	Fecha y hora en que se procesó la solicitud.

Respuestas de error

Código HTTP	Causa	Ejemplo de respuesta
400 Bad Request	Falta la contraseña en el encabezado password o es incorrecta.	{"mensaje": "Acceso denegado. Contraseña incorrecta."}

Consideraciones importantes

• Contraseña: solicítela al equipo de TI de Conexus IT; no la comparta ni la incluya en el código fuente ni en repositorios.
• Registro sin contrato ni certificado: un estado REGISTRADO indica que el emisor se creó, pero todavía no tiene contrato ni certificado asignados. Coordine con el equipo de Colfact la configuración pendiente antes de emitir documentos.
• Datos de integración: guarde de forma segura GuidEmpresa, GuidOrigen y HashSeguridad; son los datos de seguridad que se describen en Ambientes y datos de prueba.
• Tiempo de ejecución: el registro puede tardar algunos segundos, según la validación de los datos enviados.