Administrar productos

Gestiona tus productos con facilidad y eficiencia con nuestra API de productos.

Agregá o modificá productos

Éste método te permite enviar un lote de hasta 50 productos ya sea para darlos de alta o para modificarlos.

¿Qué debes tener en cuenta?

  • El código de producto debe ser único dentro de la lista de precios

  • Al modificar un producto, se utilizará como clave de búsqueda el campo "codigo" + "lista de precios"

  • Podes enviar hasta 50 productos por request.

  • El JSON a enviar es el mismo tanto para el alta como para la modificación, solo se debe cambiar el valor del campo "operacion".

  • stock_actual: Éste campo solo será utilizado en el alta del producto, cuando el campo "afecta_stock" = "S". Luego de crear el producto se incorporarán al stock las unidades indicadas.

Request

POST https://www.tusfacturas.app/app/api/v2/productos/administrar

Request Body

NameTypeDescription

productos

array

Una lista de objetos "producto"

usertoken

string

Tus credenciales de acceso

apikey

string

Tus credenciales de acceso

apitoken

string

Tus credenciales de acceso

operacion

string

Valores posibles: "A" para agregar nuevos productos o "M" para modificar productos

Ejemplo del JSON que debes enviar

{
    "usertoken": "xxxx",
    "apikey": "xxxx",
    "apitoken": "xxxx",
    "operacion": "A",
    "productos": [
        {
            "descripcion": "Tren de carga P#1",
            "unidad_bulto": "1",
            "lista_precios": "Trenes",
            "codigo": "tren10384",
            "precio_unitario_sin_iva": 1000,
            "alicuota": 21,
            "impuestos_internos_alicuota": 0,
            "moneda": "DOL",
            "codbar": "123213213213",
            "rg5329": "S",
            "unidad_medida": "7",
            "afecta_stock": "N",
            "stock_actual": 0,
            "stock_minimo": 100
        },
        {
            "descripcion": "Camion de arena",
            "unidad_bulto": "1",
            "lista_precios": "Camiones",
            "codigo": "Cam01",
            "precio_unitario_sin_iva": 1000,
            "alicuota": 21,
            "moneda": "PES",
            "codbar": "",
            "impuestos_internos_alicuota": 45,
            "unidad_medida": "7",
            "afecta_stock": "S",
            "stock_actual": 154,
            "stock_minimo": 500
        }
    ]
}

Estructura de cada "producto"

descripcion

Campo alfanumerico de hasta 255 caracteres.

codigo

Campo alfanumerico de hasta 50 caracteres.

lista_precios

Campo alfanumerico de hasta 255 caracteres.

unidad_bulto

Valor nlumerico entero.

precio_unitario_sin_iva

Valor numerico con hasta 3 decimales. Separador de decimales: punto

alicuota

Valor según tabla de referencia: "Alicuotas"

moneda

Valores posibles: "PES" para indicar "Pesos argentinos" o "DOL" para indicar "Dolares"

codbar

Campo alfanumerico de hasta 255 caracteres.

impuestos_internos_alicuota

Valor numérico con hasta 2 decimales. Separador de decimales: punto

unidad_medida

Valor según tabla de referencia: "Unidades de medida"

afecta_stock

Valores posibles: "S" o "N"

stock_actual

Valor numérico entero. Éste campo se utiliza solo en el alta de productos

stock_minimo

Valor numérico entero.

¿Qué te retorna en cada llamada?

Se devolverá una lista, en el mismo orden en que se recibió, conteniendo la siguiente estructura:

    {
	"error": "N",
	"errores": [],
	"productos": [
		{
			"codigo": "tren10384",
			"lista_precios": "Trenes",
			"error": "N",
			"errores": []
		},
		{
			"codigo": "Cam01",
			"lista_precios": "Camiones",
			"error": "S",
			"errores": [
				"Ya existe un producto en esa lista de precios con el codigo: Cam01. No se agregara."
			]
		}
	]
}

Última actualización