API CrearProducto

La API CrearProducto es un desarrollo elaborado por el equipo de The Factory HKA el cual brinda la posibilidad al contribuyente de crear todo el catalogo de productos los registrará al realizar algún documento electrónico, y posteriormente los podrá visualizar en el portal de HKA Factura en ambiente demo y en ambiente de producción o al realizar el consumo del servicio a través de la Api ConsultarProductos.

@IMPORTANTE: La API CrearProducto 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:

Para mayor información pude consultas las URL en la siguiente sección:

CrearProducto

A continuación se documenta la estructura que se debe contemplar en la construcción del Request y el Response del servicio CrearProductoy 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 emisor.
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 PROXIMAMENTE
Array <Productos>	Productos	Parámetros que conforman la clase DetalleDeFactura del Objeto Factura'
Array	Establecimientos	Parámetros que se registra el establecimiento, inventario y ubicacion para el producto a crear.

Donde Productos contiene la siguiente información:

REQUEST

Parámetros a Recibir Array Productos

Tipo	Identificador	Descripción
String	IdProducto	Identificador del Producto a crear
String	Tipo	Corresponde a la definicion si es Producto, Servicio u Otro Servicio = 1 Producto = 2 Otros = 3
String	DescripcionTipo	Correspondiente de la descripcion de la variable. UNSPSC GTIN Partida Arancelarias Estándar de adopción del contribuyente
String	Codigo	Codigo correspondiente al producto registrado
String	Descripcion	Descripcion del producto o servicio registrado
String	TipoCodigoEstandar
String	DescripcionCodigoEstandar
String	CodigoEstandar
String	IdUnidadMedida
String	UnidadMedida
String	DescripcionUnidadMedida
String	PrecioUnitario
String	Marca
String	Modelo
String	CantidadPorEmpaque
String	CantidadReal
String	InformacionAdicional
String	IdCodigoImpuesto
String	CodigoImpuesto
String	NombreCodigoImpuesto
String	DescripcionCodigoImpuesto
String	IdTarifaImpuestoIVA
String	TarifaImpuestoIVA
String	IdTarifaImpuestoINC
String	TarifaImpuestoINC
String	ValorImpuestoIC
String	TarifaImpuestoICUI
String	VolumenImpuestoIBUA
String	ValorImpuestoIBUA
String	Mandato
String	NumeroIdentificacionMandatorio
String	NumeroIdentificacionMandatorioDv
String	IdTipoIdentificacionMandatorio
String	TipoIdentificacionMandatorio
String	DescripcionTipoIdentificacionMandatorio
String	TipoPrecio
String	InventarioInicial
String	TipoIdentificacionMandatorio
String	InventarioAjuste
String	Ubicacion
String	Activo
Array	IdCategoria

Donde Establecimientos contiene la siguiente información:

REQUEST

Parámetros a Recibir Array Establecimientos

Tipo	Identificador	Descripción
String	Id	Identificador del Establacimiento
String	InventarioAjuste	Corresponde al inventario a asignar
String	Ubicacion	Corresponde a la ubicacion del inventario

RESPONSE

Parámetros a Recibir al consultar el Api CrearProducto

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 del contribuyente asignado por The Factory HKA Colombia (Uso Interno)
String	IdPorducto	Identificador del contribuyente asignado por The Factory HKA Colombia (Uso Interno)