API CrearCategoria - Historial de revisiones

Dmrodriguez2 en 21:42 27 jun 2025

2025-06-27T21:42:58Z

← Revisión anterior		Revisión del 21:42 27 jun 2025
Línea 1:		Línea 1:
	La API '''CrearCategoria''' es un desarrollo elaborado por el equipo de The Factory HKA el cual brinda la posibilidad al contribuyente de crear diferentes categorias con las cuales podrá generar un control administrativo según del modelo de facturacion del emisor, a traves de esta Api podra crear Categorias de Productos, Clientes, entre otros; en ambiente demo y en ambiente de producción		La API '''CrearCategoria''' es un desarrollo elaborado por el equipo de The Factory HKA el cual brinda la posibilidad al contribuyente de crear diferentes categorias con las cuales podrá generar un control administrativo de los productos, según del modelo de facturacion del emisor, a traves de esta Api podra crear Categorias de Productos, Clientes, entre otros; en ambiente demo y en ambiente de producción
	<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 CrearCategoria 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>

Dmrodriguez2 en 18:04 25 nov 2024

2024-11-25T18:04:05Z

← Revisión anterior		Revisión del 18:04 25 nov 2024
Línea 107:		Línea 107:
	<br>		<br>

	~~<center>'''Ejemplo Response CrearCategoria'''</center>~~
	~~[[Archivo:ResponseCrearCategoria.png\|800px\|sinmarco\|centro\|Crear Categoria]]~~
	<br />		<br />
	<br />		<br />

Dmrodriguez2 en 03:39 13 jul 2024

2024-07-13T03:39:58Z

← Revisión anterior		Revisión del 03:39 13 jul 2024
Línea 27:		Línea 27:
	\|rowspan="2"\|Suministrado por The Factory HKA Colombia según el ambiente a consultar		\|rowspan="2"\|Suministrado por The Factory HKA Colombia según el ambiente a consultar
	\|-		\|-
	\|~~TokenPassword~~		\|TokenClave
	\|-		\|-
	\|String		\|String

Dmrodriguez2: Página creada con «La API '''CrearCategoria''' es un desarrollo elaborado por el equipo de The Factory HKA el cual brinda la posibilidad al contribuyente de crear diferentes categorias con la…»

2024-02-06T20:36:42Z

Página creada con «La API '''CrearCategoria''' es un desarrollo elaborado por el equipo de The Factory HKA el cual brinda la posibilidad al contribuyente de crear diferentes categorias con la…»

Página nueva

La API '''CrearCategoria''' es un desarrollo elaborado por el equipo de The Factory HKA el cual brinda la posibilidad al contribuyente de crear diferentes categorias con las cuales podrá generar un control administrativo según del modelo de facturacion del emisor, a traves de esta Api podra crear Categorias de Productos, Clientes, entre otros; en ambiente demo y en 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 consultas las URL en la siguiente sección:'''
'''[[Tips_Urls_de_Emisión #CrearCategoria|CrearCategoria]]'''

A continuación se documenta la estructura que se debe contemplar en la construcción del Request y el Response del servicio '''CrearCategoria''' y de esta forma garantizar la implementación de este nuevo método:

; REQUEST: Parámetros a Enviar
{| 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
|Nit
|Número de documento del contribuyente a consultar
|-
|rowspan="2"|String
|TokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia según el ambiente a consultar
|-
|TokenPassword
|-
|String
|ClaveSecreta
|Definida por el contribuyente emisor a través del portal HKA Factura Electrónica en ambiente demo y en ambiente de producción.
|-
|Array <Categoria>
|Categoria
|Parametros que conforman la informacion de cada una de las categorias
|-
|}
 

Donde Class.Categoria contiene la siguiente información:

{| 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
|Id
|Identificador interno autogestionado por el Contribuyente emisor ante TFHKA, no es obligatorio puede enviarse en null para que el sistema automaticamente le genere un Id
|-
|String
|Codigo
|Identificador interno autogestionado por el Contribuyente emisor ante TFHKA.
|-
|String
|Nombre
|Nombre de la Categoria que desea Crear
|-
|String
|Descripcion
|Descripcion de la Categoria que desea Crear
|-
|}
 

; RESPONSE: Parámetros a Recibir al consultar el Método CrearCategoria
{| 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"
|-
|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
|Mensaje se confirmacion del consumo “Creacion Exitosa” ó “Mensaje de Error ”
|-
|String
|IdEmpresa
|Identificador interno del Contribuyente emisor ante TFHKA
|-
|String
|IdCategoria
|Identificador interno de la Categoria Contribuyente emisor ante TFHKA se genera automaricamente por el servicio y se puede consultar al consumir la Api ConsultarCategoria
|-
|String
|Activo
|Código que indica el estatus actual del secuencial en la plataforma de web''' 0: Inactivo''' o '''1: Activo'''. '''Uso interno TFHKA'''.
|-
|String
|Errores
|Listo de errores en caso que inconsistencias en el consumo de la Api
|-
|}
{{clear}}
 

<center>'''Ejemplo Response CrearCategoria'''</center>
[[Archivo:ResponseCrearCategoria.png|800px|sinmarco|centro|Crear Categoria]]