API CrearNumeracion

La API CrearNumeracion es un desarrollo elaborado por el equipo de The Factory HKA el cual tiene como objetivo permitir la creación de numeraciones o secuenciales para poder emitir documentos electronicos en cualquiera de nuestros ambientes demo o producción.

@IMPORTANTE: Para el consumo de este servicio se han establecido dos url especificas en ambiente DEMO y ambiente PRODUCCION las cuales las podrá encontrar a continuación:

Para mayor información pude visitar la siguiente sección:

CrearNumeracion

A continuación se documenta la estructura que se debe contemplar en la construcción del Request y el Response del servicio CrearNumeracion y de esta forma garantizar la implementación de este nuevo método:

REQUEST

Parámetros a Enviar

Array <Numeracion>

Tipo	Identificador	Descripción
String	Nit	Número de documento del contribuyente a consultar
String	TokenEmpresa	Suministrado por The Factory HKA Colombia según el ambiente a consultar
	TokenPassword
String	ClaveSecreta	Definida por el contribuyente emisor a través del portal HKA Factura Electrónica en ambiente demo y en ambiente de producción.
Numeraciones	Histórico de las numeraciones configuradas en TFHKA o asociadas en la DIAN

Donde Class.Numeraciones contiene la siguiente información:

Tipo	Identificador	Descripción
String	Id	Identificador interno autogestionado por el Contribuyente emisor ante TFHKA
String	IdTipoAmbienteSecuencial	Correspondiente a los dos posibles valores: Demo y Produccion: 2 = Producción / Proceso de Habilitacion 3 = Habilitación 2.1
String	IdTipoDocumento	Corresponde al tipo de documento que desea emitir Invoice, CreditNote, DebitNote debe corresponder a uno de los valores de la Tabla 1
String	IdTipoServicio	Correspondiente a los posibles valores: 1 = Portal / 2 = Servicio de Integración / 3 = App Móvil / 4 = Masivo (Exclusivo Nomina Electronica
String	IdModalidad	Correspondiente a los posibles valores: 1 = Automática / 2 = Manual Con Prefijo / 3 = Manual Sin Prefijo / 4 = Manual Contingencia
String	IdEstablecimiento	Numero identificador del secuencial que se desea consultar @IMPORTANTE: Puede obtenerlo al consumir la Api ConsultarEstablecimiento
String	NumeroResolucion	Numero de resolución asignado por la DIAN para esta numeraciónEn ambiente Demo deber ser autogestionada por el contribuyente
String	FechaResolucion	Fecha en la que se solicito la resolución ante la DIAN, en formato: AAAA-MM-DD. En ambiente Demo deber ser autogestionada por el contribuyente
String	Prefijo	Combinación de cifras alfanuméricas que establece al momento de solicitar la numeración o resolución. En ambiente Demo deber ser autogestionada por el contribuyente
String	NumeroDesde	Valor desde donde se da inicio a la numeración solicitada. En ambiente Demo deber ser autogestionada por el contribuyente
String	NumeroHasta	Valor hasta donde finaliza la numeración solicitada. En ambiente Demo deber ser autogestionada por el contribuyente
String	NumeroInicial	Valor desde donde se da inicio a la numeración solicitada. En ambiente Demo deber ser autogestionada por el contribuyente
String	FechaDesde	Fecha en la que se da inicio a la resolución solicitada ante la DIAN, en formato: AAAA-MM-DD En ambiente Demo deber ser autogestionada por el contribuyente
String	FechaHasta	Fecha en la que finaliza la resolución solicitada ante la DIAN, en formato: AAAA-MM-DD En ambiente Demo deber ser autogestionada por el contribuyente
String	ClaveTecnica	Cadena alfanumérica establecida por la DIAN para la numeración o resolución solicitada En ambiente Demo deber ser autogestionada por el contribuyente
String	TestSetId	Cadena alfanumérica establecida por la DIAN en la resolución de habilitación para realizar las pruebas solicitadas.

RESPONSE

Parámetros a Recibir al consultar el Método CrearNumeracion

Tipo	Identificador	Descripción
int	Código	Indica el estado de la operación retornado por el servicio
String	Resultado	Resultado del consumo del método: “Exitoso” ó “Error”
String	Mensaje	Este mensaje está asociado a la consulta realizada, "Consulta Exitosa" o "Mensaje de error"
String	Nit	Número de documento del contribuyente consultado
String	IdEmpresa	Identificador interno del Contribuyente emisor ante TFHKA
Array <Secuencial>	Secuenciales	Histórico de las numeraciones configuradas en TFHKA o asociadas en la DIAN
String	Errores	Listo de errores en caso que inconsistencias en el consumo de la Api

Donde Class.Numeraciones contiene la siguiente información:

RESPONSE

Parámetros a Recibir Array Secuenciales

Tipo	Identificador	Descripción
String	Id	Identificador del secuencial configurado en los portales de TFHKA
String	UltimoConsecutivo	Numero del ultimo documento emitido con el secuencial indicado

Ejemplo Response UltimoConsecutivo