Diferencia entre revisiones de «API ConsultarFolios»
Sin resumen de edición |
Sin resumen de edición |
||
| Línea 2: | Línea 2: | ||
<br> | <br> | ||
<br> | <br> | ||
<font color="red">'''@IMPORTANTE:'''</font> 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: | <font color="red">'''@IMPORTANTE:'''</font> La API ConsultarFolios está construida en método POST. 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: | ||
<br> | <br> | ||
Revisión actual - 13:47 27 jun 2025
La API ConsultarFolios es un desarrollo elaborado por el equipo de The Factory HKA el cual brinda la posibilidad al contribuyente de consultar los folios, comprados, consumidos y restantes adquiridos con el servicio de The Factory HKA para el ambiente demo y en ambiente de producción.
@IMPORTANTE: La API ConsultarFolios está construida en método POST. 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 consultas las URL en la siguiente sección:
ConsultarFolios
A continuación se documenta la estructura que se debe contemplar en la construcción del Request y el Response del servicio ConsultarFolios 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 |
| TokenClave |
- RESPONSE
- Parámetros a Recibir al consultar el Método ConsultarFolios
| 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 | Resumen de folios insertado exitosamente en la Redis Caché |
| String | Nit | Número de documento del contribuyente consultado |
| String | IdEmpresa | Identificador del contribuyente asignado por The Factory HKA Colombia (Uso Interno) |
| String | Errores | Identificador hace referencia a los errores que se puedan presentar |
| Folios<Folios> | Folios | Contiene al informacion referente a los proceso de carga de folios del contribuyente. |
Donde Folios contiene la siguiente información:
- RESPONSE
- Parámetros a Recibir Array Folios
| Tipo | Identificador | Descripción |
|---|---|---|
| String | Comprados | Informa el valor de folios adquiridos por el contribuyente |
| String | Consumidos | Informa el valor de folios utilizados por el cliente |
| String | ConsumidosValidacionPosterior | Informaba el valor de folios utilizados en para validacion posterior |
| String | Restantes | Informa el valor de folios dospinibles para emision de documentos |
| String | Fuente | Informa Basede Datos |