Info Artículo

A continuación encontrarás el array de datos que compone a un artículo, la primera sección son datos requeridos por la DNIT y la siguiente, parámetros adicionales que podrás declarar según desees. La mayoría de la información la encontrarás en las otras páginas de esta sección.

Mas abajo encontrarás el ejemplo de 3 artículos con distintos tipos de impuestos (con los datos obligatorios mínimos requeridos).

Estructura con datos obligatorios y opcionales

{
    "codigo": "TEST001",
    "descripcion": "ARTICULO PRUEBA NRO 1",
    "unidadMedida": 77,
    "cantidad": 1.00000000,
    "precioUnitario": 5500,
    "descuento": 0,

    "ivaTipo": 1,
    "ivaBase": 100,
    "iva": 10,

    "observacion": "Alguna información adicional o complementaria sobre el producto, sin caracteres especiales salvo coma y paréntesis", 
    "vencimiento" : "2022-10-30",
    "numeroSerie" : "123456",
    "importador" : {
        "nombre" : "Importador Ywe S.A.",
        "direccion" : "Calle Falsa 123",
        "registroImportador" : "Importadora Parana S.A."
    }
}

Datos obligatorios del artículo: codigo, descripcion, unidadMedida (77 = unitario, ver el resto de valores aquí), cantidad (admite hasta 8 decimales según necesidad), precioUnitario, descuento.

Datos obligatorios de IVA: ivaTipo, ivaBase, iva - ver Parámetros de IVA más abajo.

Parámetros opcionales (omitibles si no se cuenta con el dato): observacion, vencimiento, numeroSerie, importador.

Parámetros de IVA

• ivaTipo: El tipo de IVA que posee este artículo:
  • 1: Gravada
  • 2: Exonerado
  • 3: Exento
  • 4: Parcial
• ivaBase: Cuanto (en %) del IVA afectará al artículo. En todos los casos será 100, salvo en Parcial, donde allí ya depende de cuanto % de IVA tiene específicamente el producto según su naturaleza.
• iva: La tasa del IVA:
  • 5: 5%
  • 10: 10%
  • 0: Exento

Otros detalles

• cantidad: La cantidad puede ser enviada con hasta 8 decimales según necesidad. Esto para que salga correctamente el cálculo (cantidad * precioUnitario) = precioTotal, que podría presentarse en productos con unidades de medida como Kg, Lt, etc.

Ejemplo Artículo IVA 5%

{
    "codigo": "107272",
    "descripcion": "ARROZ SELECTA T3 500 GR",
    "unidadMedida": 77,
    "cantidad": 1,
    "precioUnitario": 3650,
    "descuento": 0,
    "ivaTipo": 1,
    "ivaBase": 100,
    "iva": 5
}

Ejemplo Artículo IVA 10%

{
    "codigo": "PC-133925",
    "descripcion": "Xiaomi Redmi Note 14 Pro 5G Dual",
    "unidadMedida": 77,
    "cantidad": 1,
    "precioUnitario": 2102000,
    "descuento": 0,
    "ivaTipo": 1,
    "ivaBase": 100,
    "iva": 10
}

Ejemplo Artículo IVA Exento

{
    "codigo": "9984",
    "descripcion": "CUOTA JULIO-2025",
    "unidadMedida": 77,
    "cantidad": 1,
    "precioUnitario": 450000,
    "descuento": 0,
    "ivaTipo": 3,
    "ivaBase": 0,
    "iva": 0
}