Ejemplos por país
📦 Gestionar productos
Crear nuevos productos
Los productos pueden ser cualquier cosa que compre o venda: mercancías o servicios. Un producto puede tener una cantidad disponible en múltiples bodegas y mostrar diferentes precios según las listas de precios.
- Endpoint: https://apifacto.com/v1/products
- Método: POST
- Cabeceras requeridas:
- Content-Type: application/json
- Authorization: Bearer \<token>
- Accept: /
Mercadería o servicio
El campo type (obligatorio) indica si el producto es un producto variable:
0: producto normal.1: maestro de producto variable.
El producto se crea como mercadería (con control de inventario) cuando se envía inventories o cuando type es 1.
Si no se envía inventories y type es 0, el producto se crea como servicio.
Para crear una mercadería con stock inicial, envíe en inventories.details la bodega (product_location_id) y la
cantidad disponible. Las bodegas se obtienen con el endpoint /product_locations.
Sincronización con su tienda en línea
Si la cuenta tiene activa una integración con WooCommerce, Shopify o Jumpseller, los productos activos (status = 1)
y con SKU se envían a la tienda, y se relacionan por SKU. El stock inicial también se sincroniza. Para sincronizarse,
el producto debe tener un precio en la lista de precios 1.
Con ecommerce_status (opcional) puede indicar cómo se crea el producto en WooCommerce:
publish: publicado (valor por defecto).draft: borrador, para completar fotos, descripción, categorías y atributos antes de publicarlo.
Las modificaciones (PUT) y eliminaciones (DELETE) de productos también se envían a la tienda.
{
"name": "papas fritas lays",
"invoicing_details": "",
"additional_details": "",
"model": "",
"brand": "",
"status": 1,
"sku": "33",
"measure_unit": null,
"type": 0,
"embedded_quantity_barcode": null,
"embedded_quantity_barcode_decimals": null,
"additional_data_1": "aaa",
"additional_data_2": "bbb",
"additional_data_3": "ccc",
"favorite": 1,
"product_category_id": null,
"ecommerce_status": "draft",
"cost": {
"currency_id": 39,
"value": 2344
},
"price": [
{
"product_price_list_id": 1,
"unit_net": 1680.672269,
"unit_tax": 319.327731,
"unit_total": 2000,
"currency_id": "39",
"sales_commission_percentage": null,
"taxes": [
{
"tax_type_id": "387",
"tax_percentage": 19,
"tax_amount": 319.327731
}
]
}
],
"inventories": {
"details": [
{
"product_location_id": 1,
"available_quantity": 25
}
],
"total_available": 25,
"total_reserved": 0
}
}
Crear nuevas categorías de productos
Los productos pueden pertenecer opcionalmente a una categoría. Las categorías también pueden tener una jerarquía al tener una categoría padre.
- Endpoint: https://apifacto.com/v1/product_categories
- Método: POST
- Cabeceras requeridas:
- Content-Type: application/json
- Authorization: Bearer \<token>
- Accept: /
{
"account_id": 39,
"name": "categoria ejemplo API 3",
"parent_product_category_id": null
}
Crear nuevas ubicaciones de productos
Las ubicaciones pueden ser bodegas, vehículos de transporte, tiendas u otros lugares donde almacena productos.
- Endpoint: https://apifacto.com/v1/product_locations
- Método: POST
- Cabeceras requeridas:
- Content-Type: application/json
- Authorization: Bearer \<token>
- Accept: /
{
"account_id": 39,
"name": "bodega pruebas",
"status": 1,
"company_branch_id": 1
}
Crear nueva lista de precios de productos
Las listas de precios le permiten definir diferentes precios para el mismo producto y así ofrecer precios personalizados a sus clientes.
- Endpoint: https://apifacto.com/v1/product_price_lists
- Método: POST
- Cabeceras requeridas:
- Content-Type: application/json
- Authorization: Bearer \<token>
- Accept: /
{
"account_id": 39,
"name": "new product price list"
}