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 | Definida por el contribuyente emisor desde el usuario root a través del portal HKA Factura Electrónica en ambiente demo y en ambiente de producción. |
| String | Identificador | Nombre del catalogo que desea asociar |
| String | IdsCatalogo | Codigo de la unidadMedida a asociar. |
- 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:
|
| 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 |