Crear Producto

Esta funcionalidad te permite crear un producto/servicio, configurando sus características como se puede ver en los siguientes campos:

Nombre	Tipo	Descripción	Características
code	string	Código único del producto.	Campo obligatorio, alfanumérico, NO permite espacios, máximo 30 caracteres.
name	string	Nombre del producto.	Campo obligatorio, máximo 100 caracteres, permite caracteres especiales y espacios.
account_group	number	ID de la clasificación de inventario.	Campo obligatorio. Debe estar creado en Siigo Nube, estar activo y se puede consultar en el siguiente endpoint: `/account-groups`.
unit	string	Código de la unidad de medida del producto del catálogo del SAT.	Campo obligatorio. Consulte el listado de códigos válidos por el SAT aquí.
key	string	Clave SAT.	Campo obligatorio. Consulte el listado de claves válidas por el SAT aquí.
type	string	Tipo del producto: Product, Service, ConsumerGood	Campo opcional. Si no se envía, se toma por defecto el valor `Product`.
stock_control	boolean	Manejo del control de inventario	Campo opcional. Si no se envía, por defecto toma `false`.
active	boolean	Estado del producto en Siigo.	Campo opcional. Por defecto toma `true`.
tax_included	boolean	IVA incluido.	Campo opcional. Indica si el precio de venta tiene IVA incluido. Por defecto toma `false`.
tax.id	number	Identificador único del impuesto.	Campo opcional. El impuesto debe existir previamente en Siigo Nube. Consulte el endpoint: `/taxes`.
prices.price_list.position	number	Identificador único de la lista de precio.	Campo opcional. Debe ser un número entero del 1 al 12.
prices.price_list.value	number	Valor de la lista de precio.	Campo opcional. Máximo 2 decimales, debe ser positivo.
reference	string	Referencia o código de fábrica del producto o servicio.	Campo opcional. Alfanumérico, permite espacios, máximo 80 caracteres.
description	string	Descripción del producto o servicio.	Campo opcional. Máximo 2500 caracteres.
barcode	string	Código de barras.	Campo opcional. Alfanumérico, permite espacios, máximo 50 caracteres.
brand	string	Marca.	Campo opcional. Alfanumérico, permite espacios, máximo 50 caracteres.

¿Como crear productos en Siigo Nube?

Aquí encontrarás las Unidades de Medida que puedes utilizar en Siigo API.

Authorization

application/json<token>

In: header

Authorization<token>

[access_token]

In: header

SiigoAPI-Application-Id<token>

nombre de la aplicación que estás integrando

In: header

Request Body

application/jsonRequired

Representa la solicitud con la información del producto.

product_idstring

Representa el Id único del producto, este valor debe ser un Guid con el siguiente formato 00000000-0000-0000-0000-000000000000.

Format: "uuid"

code

Required

string

Representa el código de identificación del producto. Este valor puede ser un código alfanumérico que representará el código de identificación del centro de coste. Por ejemplo, este nombre puede ser 'Item-1' o 'toy007'.

name

Required

string

Representa el nombre del producto o servicio.

account_group

Required

integer

Representa el id de la clasificación de inventario.

Format: "int64"

type

Required

string

Representa el tipo de producto. Este producto puede ser de tipo 'Product', 'Service' o 'Consumer Good', por defecto este campo será 'Product'.

stock_controlboolean

Representa el control de inventario. Este campo puede ser 'true' o 'false', por defecto este campo será false.

activeboolean

Representa el estado del producto. Este campo puede ser 'true' o 'false', por defecto este campo será true.

tax_classificationstring

Representa la clasificación de impuestos, este campo puede ser 'Taxed', 'Exempt' o 'Excluded'.

tax_includedboolean

Representa si este producto tiene IVA incluido. Este campo puede ser 'true' o 'false'.

tax_consumption_valuenumber

Representa el valor del impuesto de consumo.

Format: "double"

taxesarray<object>

Contiene una lista con los ids de los impuestos asociados al producto.

pricesarray<object>

Contiene una lista con 'lista de precios' del producto. Cada producto puede tener hasta 12 lista de precios.

unit

Required

string

Unidad de medida SAT del producto.

key

Required

string

Clave SAT del producto.

referencestring

Representa el código de referencia o de fábrica del producto o servicio.

descriptionstring

Representa la descripción del producto.

additional_fieldsobject

curl -X POST "https://api.siigo.mx/v1/products" \
  -H "application/json: <token>" \
  -H "Authorization: <token>" \
  -H "SiigoAPI-Application-Id: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "63f918c2-ca65-4edc-a7db-66bcdd5159fb",
    "code": "Item-1",
    "name": "Cotton shirt",
    "account_group": 1253,
    "type": "Product",
    "stock_control": false,
    "active": true,
    "tax_classification": "Taxed",
    "tax_included": false,
    "tax_consumption_value": 0,
    "taxes": [
      {
        "id": 13156
      }
    ],
    "prices": [
      {
        "currency_code": "string",
        "price_list": [
          {
            "position": 1,
            "value": 1069.77
          }
        ]
      }
    ],
    "unit": "A37",
    "key": "94101701",
    "reference": "REF1",
    "description": "Esta es una descripción",
    "additional_fields": {
      "barcode": "B0123",
      "brand": "Gef",
      "tariff": "string",
      "model": "Loiry"
    }
  }'

Producto creado con éxito.

{
  "id": "string",
  "code": "string",
  "name": "string",
  "account_group": {
    "id": 0,
    "name": "string"
  },
  "type": "string",
  "stock_control": true,
  "active": true,
  "tax_classification": "string",
  "tax_included": true,
  "tax_consumption_value": 0,
  "taxes": [
    {
      "id": 0,
      "name": "string",
      "type": "string",
      "percentage": 0
    }
  ],
  "prices": [
    {
      "currency_code": "string",
      "price_list": [
        {
          "position": 0,
          "name": "string",
          "value": 0
        }
      ]
    }
  ],
  "unit": {
    "code": "string",
    "name": "string"
  },
  "key": "string",
  "reference": "string",
  "description": "string",
  "additional_fields": {
    "barcode": "string",
    "brand": "string",
    "tariff": "string",
    "model": "string"
  },
  "available_quantity": 0,
  "warehouses": [
    {
      "id": 0,
      "name": "string",
      "quantity": 0
    }
  ],
  "metadata": {
    "created": "string",
    "last_updated": "string",
    "stock_updated": "string"
  }
}

Crear Producto

Authorization

Request Body

Response

TypeScript