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

💡 El uso de éste método contabiliza como un request en tu suscripción

Request Body

Name	Type	Description
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."
			]
		}
	]
}