API ConsultarNumeraciones

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

API ConsultarNumeraciones

La API ConsultarNumeracion es un desarrollo elaborado por el equipo de The Factory HKA el cual tiene como objetivo conocer las resoluciones que tiene cada contribuyente convalidadas en el portal de la DIAN y a su vez poder validar los secuenciales que tiene el contribuyente configurados en el portal de factura electrónica en ambiente demo y en ambiente de 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:
 ConsultarNumeraciones


ConsultarNumeraciones

A continuación se documenta la estructura que se debe contemplar en la construcción del Request y el Response del servicio ConsultarNumeracion 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 Plataforma Nombre de la plataforma a consultar numeración TFHKA o DIAN


RESPONSE
Parámetros a Recibir al consultar el Método ConsultarNumeraciones
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 al codigo, útil para identificación de errores
String Nit Número de documento del contribuyente consultado
String Plataforma Nombre de la plataforma a consultar numeración TFHKA o DIAN
Array <Numeraciones> Numeraciones Histórico de las numeraciones configuradas en TFHKA o asociadas en la DIAN

Donde Class.Numeraciones contiene la siguiente información:

RESPONSE
Parámetros a Recibir Array Numeraciones
Tipo Identificador Descripción
String IdNumeracion Identificador del secuencial configurado. Uso interno TFHKA.
String NumeroResolucion Numero de resolución asignado por la DIAN para esta numeración
String FechaResolucion Fecha en la que se solicito la resolución ante la DIAN, en formato: AAAA-MM-DD
String Prefijo Combinación de cifras alfanuméricas que establece al momento de solicitar la numeración o resolución
String NumeroDesde Valor desde donde se da inicio a la numeración solicitada.
String NumeroHasta Valor hasta donde finaliza la numeración solicitada.
String NumeroInicial Valor desde donde se da inicio a la numeración solicitada. Uso interno TFHKA.
String FechaDesde Fecha en la que se da inicio a la resolución solicitada ante la DIAN, en formato: AAAA-MM-DD
String FechaHasta Fecha en la que finaliza la resolución solicitada ante la DIAN, en formato: AAAA-MM-DD
String ClaveTecnica Cadena alfanumérica establecida por la DIAN para la numeración o resolución solicitada. Uso interno TFHKA.
String TipoDocumento Código para Invoice, CreditNote, DebitNote. Corresponde a uno de los valores de la Tabla 1. Uso interno TFHKA.
String IdEstablecimiento Identificador del establecimiento configurado por el contribuyente en el portal web. Uso interno TFHKA.
String CodigoEstablecimiento Código del establecimiento configurado por el contribuyente en el portal web. Uso interno TFHKA.
String DescripcionEstablecimiento Descripción del establecimiento configurado por el contribuyente en el portal web. Uso interno TFHKA.. Ejemplo: Principal, Oficina
String DireccionEstablecimiento Dirección del establecimiento configurado por el contribuyente en el portal web. Uso interno TFHKA.
String TipoServicio Código que Define si el secuencial fue configurado para Portal o Servicio de Integración. Uso interno TFHKA.
String Modalidad Código que Define si el secuencial fue configurado para 1: Automática o 2: Manual con Prefijo , 3: Manual sin prefijo, Uso interno TFHKA.
String TipoAmbienteSecuencial Código que Define si el ambiente en el cual se configuro el secuencial en el portal de TFHKA 2: Producción 2.1 o 3: Habilitación 2.1. Uso interno TFHKA.
String TestSetId Cadena alfanumérica establecida por la DIAN en la resolución de habilitación para realizar las pruebas solicitadas.Uso interno TFHKA.
String EnvioDian Código que Define si el secuencial se encuentra generando envíos directo a la DIAN. Uso interno TFHKA.
String Activo Código que indica el estatus actual del secuencial en la plataforma de web 0: Inactivo o 1: Activo. Uso interno TFHKA.


Ejemplo Response Numeración TFHKA
NumeracionTFHKA



Ejemplo Response Numeración DIAN
Numeracion DIAN