Appearance

Productos y Servicios ​

Productos y servicios comparten la misma estructura base. Los productos tienen campos adicionales: images y total. Los endpoints son similares reemplazando products por services.

Modelo principal ​

ts
interface Principal {
  code: string;
  auxiliarCode?: string;
  price?: number;
  description: string;
  iva?: string;
  aditionalInformation?: InfoAdicional[];
  status?: "active" | "inactive";
  _movements: Movement[];
}

Información adicional ​

ts
interface InfoAdicional {
  nombre: string;
  valor: string;
}

TIP

Los campos iva, ice e irbpnr aceptan como valor el id de las opciones que retorna el endpoint /v3/production/products/get-options. Siempre consulta este endpoint para obtener los valores actualizados según la normativa del SRI vigente.

Obtener un producto o servicio ​

GET/v3/production/products-services/:id
TESThttps://api-test.upconta.com/v3/production/products-services/:id
PRODhttps://api.upconta.com/v3/production/products-services/:id
json
{
  "_id": "60...",
  "code": "COD001",
  "price": 100.00,
  "description": "Producto de ejemplo"
}

Productos ​

Modelo ​

ts
interface Producto {
  claveUnidad?: string;
  total?: number;
  bodegas: [];
}

Opciones de productos ​

GET/v3/production/products/get-options
TESThttps://api-test.upconta.com/v3/production/products/get-options
PRODhttps://api.upconta.com/v3/production/products/get-options
json
{
  "PorcentajesDeIVA": [
    { "id": "0", "description": "0%", "value": 0 },
    { "id": "2", "description": "12%", "value": 0.12 },
    { "id": "4", "description": "15%", "value": 0.15 },
    { "id": "5", "description": "5%", "value": 0.05 },
    { "id": "6", "description": "No objeto de impuesto", "value": 0 },
    { "id": "7", "description": "Exento de IVA", "value": 0 },
    { "id": "8", "description": "8%", "value": 0.08 },
    { "id": "10", "description": "13%", "value": 0.13 }
  ],
  "PorcentajesDeICE": [
    { "id": "3011", "description": "Cigarrillos rubios" },
    { "id": "3031", "description": "Bebidas alcohólicas", "value": 0.75 },
    { "id": "3610", "description": "Perfumes y aguas de tocador", "value": 0.2 }
  ]
}

Obtener productos ​

GET/v3/production/products
TESThttps://api-test.upconta.com/v3/production/products
PRODhttps://api.upconta.com/v3/production/products
json
{
  "page": 1,
  "total": 10,
  "data": [
    {
      "_id": "60...",
      "code": "COD001",
      "description": "Producto de ejemplo"
    },
    {
      "_id": "60...",
      "code": "COD002",
      "price": 50.00,
      "description": "Otro producto"
    }
  ]
}

Obtener producto ​

GET/v3/production/products/:id
TESThttps://api-test.upconta.com/v3/production/products/:id
PRODhttps://api.upconta.com/v3/production/products/:id
json
{
  "_id": "60...",
  "code": "COD001",
  "description": "Producto de ejemplo"
}

Crear producto ​

POST/v3/production/products
TESThttps://api-test.upconta.com/v3/production/products
PRODhttps://api.upconta.com/v3/production/products
json
{
  "code": "COD001",
  "auxiliarCode": "AUX001",
  "price": 100.00,
  "description": "Producto de ejemplo",
  "iva": "2",
  "ice": "3620"
}

Editar producto ​

PUT/v3/production/products/:id
TESThttps://api-test.upconta.com/v3/production/products/:id
PRODhttps://api.upconta.com/v3/production/products/:id
json
{
  "description": "Descripción actualizada"
}

Eliminar producto ​

DELETE/v3/production/products/:id
TESThttps://api-test.upconta.com/v3/production/products/:id
PRODhttps://api.upconta.com/v3/production/products/:id
json
{
  "message": "success"
}

Servicios ​

Los servicios usan el modelo principal. Los endpoints son los mismos que en productos, reemplazando products por services.