Productos

Productos

Un producto es una unidad vendible que puede estar compuesto por uno o más SKU

Listar productos

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/products/search

Obtiene un listado paginado de productos para la cuenta autenticada.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de consulta

per_pageintegerOpcional

Cantidad de productos por página

Default: 50

Respuestas

200

Listado de productos

application/json

500

Error interno del servidor

get

/products/search

HTTPcURLJavaScriptPython

GET /v2/products/search HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "data": [
    {
      "id": 1,
      "account_id": "12345",
      "reference_code": "PRD-001",
      "name": "[Proveedor] Producto X",
      "skus": [
        {
          "sku": "SKU-001",
          "units": 10,
          "data": {
            "name": "SKU Name",
            "internal_sku": "INT001",
            "barcode": "123456789",
            "attributes": {
              "unit_declared_value": 100.5,
              "weight": 1.2,
              "length": 10,
              "width": 5,
              "height": 2
            },
            "classification": "General",
            "stackable": true
          }
        }
      ],
      "created_at": "2024-06-01T12:00:00Z",
      "updated_at": "2024-06-01T12:00:00Z",
      "supplier": {
        "id": 1,
        "name": "Proveedor X",
        "account_id": 100
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 1,
    "total": 1,
    "last_page": 1,
    "from": 1,
    "to": 1
  },
  "links": {
    "first": "text",
    "last": "text",
    "prev": "text",
    "next": "text"
  }
}

Obtener detalle de producto

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/products/{productId}

Devuelve el detalle de un producto específico para la cuenta autenticada.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta

productIdintegerRequerido

ID del producto

Respuestas

200

Detalle del producto

application/json

404

Producto no encontrado

500

Error interno del servidor

get

/products/{productId}

HTTPcURLJavaScriptPython

GET /v2/products/{productId} HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "id": 1,
  "account_id": "12345",
  "reference_code": "PRD-001",
  "name": "[Proveedor] Producto X",
  "skus": [
    {
      "sku": "SKU-001",
      "units": 10,
      "data": {
        "name": "SKU Name",
        "internal_sku": "INT001",
        "barcode": "123456789",
        "attributes": {
          "unit_declared_value": 100.5,
          "weight": 1.2,
          "length": 10,
          "width": 5,
          "height": 2
        },
        "classification": "General",
        "stackable": true
      }
    }
  ],
  "created_at": "2024-06-01T12:00:00Z",
  "updated_at": "2024-06-01T12:00:00Z",
  "supplier": {
    "id": 1,
    "name": "Proveedor X",
    "account_id": 100
  }
}

Crear producto

post

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/products

Crea un nuevo producto para la cuenta autenticada. Los SKUs pueden especificarse de dos formas: 1) Referenciando SKUs existentes por su código (string), o 2) Creando nuevos SKUs inline proporcionando un objeto completo con todos los datos del SKU.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Cuerpo

application/json

Datos para crear un nuevo producto con SKUs

reference_codestring · máx: 255Requerido

Código de referencia único del producto

Example: PROD-001

namestring · máx: 255Requerido

Nombre del producto

Example: Producto de Ejemplo

enabled_for_fulfillmentbooleanOpcional

Indica si el producto está habilitado para cumplimiento

Example: true

uses_special_volumebooleanOpcional

Indica si el producto utiliza volumen especial

Example: false

Respuestas

201

Producto creado exitosamente

application/json

422

Datos inválidos

500

Error interno del servidor

post

/products

HTTPcURLJavaScriptPython

POST /v2/products HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 450

{
  "reference_code": "PROD-001",
  "name": "Producto de Ejemplo",
  "enabled_for_fulfillment": true,
  "uses_special_volume": false,
  "skus": [
    {
      "sku": {
        "sku": "SKU-002",
        "name": "SKU de Ejemplo",
        "classification_id": 1,
        "unit_declared_value": 10.5,
        "currency": "USD",
        "weight": 500,
        "length": 10,
        "width": 5,
        "height": 2,
        "tax_class_code": "TC-01",
        "stackable": true,
        "management_type": "lot",
        "units_per_master_case": 20,
        "master_cases_per_pallet": 10,
        "total_units_per_pallet": 200
      },
      "units": 10
    }
  ]
}

{
  "id": 1,
  "account_id": "12345",
  "reference_code": "PRD-001",
  "name": "[Proveedor] Producto X",
  "skus": [
    {
      "sku": "SKU-001",
      "units": 10,
      "data": {
        "name": "SKU Name",
        "internal_sku": "INT001",
        "barcode": "123456789",
        "attributes": {
          "unit_declared_value": 100.5,
          "weight": 1.2,
          "length": 10,
          "width": 5,
          "height": 2
        },
        "classification": "General",
        "stackable": true
      }
    }
  ],
  "created_at": "2024-06-01T12:00:00Z",
  "updated_at": "2024-06-01T12:00:00Z",
  "supplier": {
    "id": 1,
    "name": "Proveedor X",
    "account_id": 100
  }
}

Actualizar producto

put

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/products/{productId}

Actualiza los datos de un producto específico para la cuenta autenticada. Los SKUs pueden especificarse de dos formas: 1) Referenciando SKUs existentes por su código (string), o 2) Creando nuevos SKUs inline proporcionando un objeto completo con todos los datos del SKU.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta

productIdintegerRequerido

ID del producto

Cuerpo

application/json

namestring · máx: 255Opcional

Product name

reference_codestring · máx: 100Opcional

Unique reference code

enabled_for_fulfillmentbooleanOpcional

If product is enabled for fulfillment

uses_special_volumebooleanOpcional

If product uses special volume

Respuestas

200

Producto actualizado exitosamente

application/json

404

Producto no encontrado

422

Datos inválidos

500

Error interno del servidor

put

/products/{productId}

HTTPcURLJavaScriptPython

PUT /v2/products/{productId} HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "name": "text",
  "reference_code": "text",
  "enabled_for_fulfillment": true,
  "uses_special_volume": true,
  "skus": [
    {
      "sku": "SKU-001",
      "units": 1
    }
  ]
}

{
  "id": 1,
  "account_id": "12345",
  "reference_code": "PRD-001",
  "name": "[Proveedor] Producto X",
  "skus": [
    {
      "sku": "SKU-001",
      "units": 10,
      "data": {
        "name": "SKU Name",
        "internal_sku": "INT001",
        "barcode": "123456789",
        "attributes": {
          "unit_declared_value": 100.5,
          "weight": 1.2,
          "length": 10,
          "width": 5,
          "height": 2
        },
        "classification": "General",
        "stackable": true
      }
    }
  ],
  "created_at": "2024-06-01T12:00:00Z",
  "updated_at": "2024-06-01T12:00:00Z",
  "supplier": {
    "id": 1,
    "name": "Proveedor X",
    "account_id": 100
  }
}

Eliminar producto

delete

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/products/{productId}

Elimina un producto específico para la cuenta autenticada.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta

productIdintegerRequerido

ID del producto

Respuestas

200

Producto eliminado exitosamente

application/json

404

Producto no encontrado

500

Error interno del servidor

delete

/products/{productId}

HTTPcURLJavaScriptPython

DELETE /v2/products/{productId} HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "message": "text",
  "product_id": 1,
  "skus_deleted": [
    "text"
  ],
  "skus_kept": [
    "text"
  ],
  "skus_kept_reason": "text"
}