API UltimoConsecutivo
La API UltimoConsecutivo 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 para el ambiente demo o el 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:
UltimoConsecutivo
A continuación se documenta la estructura que se debe contemplar en la construcción del Request y el Response del servicio UltimoConsecutivo 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 | IdNumeracion | Numero identificador del secuencial que se desea consultar |
- 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:
|
| 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. |
