API UltimoConsecutivo

De tfhkacolwiki
Revisión del 03:35 13 jul 2024 de Dmrodriguez2 (discusión | contribuciones)
(dif) ← Revisión anterior | Revisión actual (dif) | Revisión siguiente → (dif)
Ir a la navegación Ir a la búsqueda

La API UltimoConsecutivo es un desarrollo elaborado por el equipo de The Factory HKA el cual tiene como objetivo permitir consultar el consecutivo mas alto emitido desde el ERP y firmado por la DIAN con alguna resolucion asignada, espesifica de las configuradas en los 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:

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
TokenClave
String IdNumeracion Numero identificador del secuencial que se desea consultar

@IMPORTANTE:Puede obtenerlo al consumir la Api ConsultaNumeraciones


RESPONSE
Parámetros a Recibir al consultar el Método UltimoConsecutivo
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
Ultimo Consecutivo Emitido