API AsociarCatalogoAsociado

La API AsociarCatalogoAsociado facilita la vinculación de nuevos catálogos a un contribuyente. Esta API es utilizada para establecer la relación entre un catálogo existente y un contribuyente, habilitando así el uso de los ítems definidos en ese catálogo para dicho contribuyente en operaciones posteriores (ej., emisión de documentos fiscales).

@IMPORTANTE: La API AsociarCatalogoAsociado está construida en metodo 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:

AsociarCatalogoAsociado

A continuación se documenta la estructura que se debe contemplar en la construcción del Request y el Response del servicio AsociarCatalogoAsociado 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	ClaveSecreta	Clave definida por el contribuyente emisor desde el usuario root en el portal HKA Factura Electrónica (aplicable tanto en ambientes de demo como de producción) para autorizar esta acción.
String	Identificador	Nombre o identificador único del catálogo maestro al cual se desean asociar los elementos especificados en IdsCatalogo (ej. "UnidadesMedida").
Array de Strings	IdsCatalogo	(Lista/Array) Conjunto de códigos o identificadores de los elementos específicos del catálogo maestro (Identificador) que se desean asociar al contribuyente (ej. ["NIU", "UND"]). Cada elemento dentro de la lista debe ser una cadena de texto.

RESPONSE

Parámetros a Recibir al consultar el Método AsociarCatalogoAsociado

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	Identificador del contribuyente asignado por The Factory HKA Colombia (Uso Interno)
String	idEmpresa	Identificador interno del Contribuyente emisor ante TFHKA
String	Identificador	Nombre del catalogo asociado a la cuenta
String	Ids	Codigo de la unidadMedida asociada
String	Array <Errores>	Lista de errores en caso de error al consumo del servicio