Diferencia entre revisiones de «API ConsultarNumeraciones»

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda
Línea 1: Línea 1:
 
<includeonly>=</includeonly>== <font color="Blue"> API ConsultarNumeraciones </font> ==<includeonly>=</includeonly>
 
<includeonly>=</includeonly>== <font color="Blue"> API ConsultarNumeraciones </font> ==<includeonly>=</includeonly>
 
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.
 
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.
 +
<br>
 +
<br>
 +
<font color="red">'''@IMPORTANTE:'''</font> Para el consumo de 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:
 +
'''[[Tips_Urls_de_Emisión| Tips Urls de Emisión]]'''
 +
<br>
  
 
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:
 
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:
Línea 26: Línea 33:
 
|}
 
|}
 
<br>
 
<br>
; RESPONSE: Parámetros a Recibir Consulta Plataforma TFHKA
+
; RESPONSE: Parámetros a Recibir al consultar el Método ConsultarNumeraciones
 
{| class="mw-collapsible wikitable"  
 
{| class="mw-collapsible wikitable"  
 
! style="background:#f2f2f2; text-align:center;"|Tipo
 
! style="background:#f2f2f2; text-align:center;"|Tipo
Línea 57: Línea 64:
 
|Numeraciones
 
|Numeraciones
 
|Histórico de las numeraciones configuradas en TFHKA o asociadas en la DIAN
 
|Histórico de las numeraciones configuradas en TFHKA o asociadas en la DIAN
 +
|-
 +
|}
 +
{{clear}}
 +
 +
Donde Class.Numeraciones contiene la siguiente información:
 +
 +
; RESPONSE: Parámetros a Recibir Array Numeraciones
 +
{| class="mw-collapsible wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Tipo
 +
! style="background:#f2f2f2; text-align:center;"|Identificador
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|- valign="center"
 
|-
 
|-
 
|String
 
|String
Línea 148: Línea 167:
 
<center>'''Ejemplo  Response Numeración TFHKA'''</center>
 
<center>'''Ejemplo  Response Numeración TFHKA'''</center>
 
[[Archivo:NumeracionTFHKA.png|800px|sinmarco|centro|NumeracionTFHKA]]
 
[[Archivo:NumeracionTFHKA.png|800px|sinmarco|centro|NumeracionTFHKA]]
 +
<br />
 +
<br />
 +
<center>'''Ejemplo  Response Numeración DIAN'''</center>
 +
[[Archivo:NumeracionDIAN.png|800px|sinmarco|centro|Numeracion DIAN]]

Revisión del 15:28 21 oct 2022

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 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:
 Tips Urls de Emisión


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
String TipoDocumento Código para Invoice, CreditNote, DebitNote uso interno TFHKA. Corresponde a uno de los valores de la Tabla 1
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.
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