API CrearNumeracion

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda

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:

CrearNumeraciones

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
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.
Array <Numeracion> 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 Código para Invoice, CreditNote, DebitNote. Corresponde 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, "Creacion Exitosa" o "Mensaje de error"
String Nit Número de documento del contribuyente al cual se crea Numeración
String IdEmpresa Identificador interno del Contribuyente emisor ante TFHKA
String IdNumeracion Identificadorautogestinado por el contribuyente emisor al crear la numeracion el servicio de TFHKA asignara un nuevo ID el cual se puede obtenerlo al consumir la Api ConsultaNumeraciones
String Errores Listo de errores en caso que inconsistencias en el consumo de la Api


Ejemplo Response CrearNumeracion
Crear Numeracion