API UltimoConsecutivo

De tfhkacolwiki
Revisión del 17:59 25 nov 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