| Nombre del campo | Es requerido? | Comentarios |
|---|---|---|
| fecha | REQUERIDO | Campo fecha. Formato esperado: dd/mm/aaaa. Ejemplo: 13/05/2018. Si usas el metodo asincrónico, la fecha será el día que queres que se emita. Una vez emitido un comprobante (factura, nota de crédito o débito) en AFIP/ARCA con una fecha determinada, no podrás emitir otro comprobante del mismo punto de venta con una fecha anterior. Esta restricción es impuesta por AFIP/ARCA y no puede ser modificada, incluso mediante la emisión de notas de crédito o débito. |
| tipo | REQUERIDO | Campo alfabético según tabla de referencia de Tipos de comprobantes |
| operacion | REQUERIDO | Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C). Valores Permitidos: V, C Ejemplo: V |
| idioma | REQUERIDO | Campo numérico. Longitud 1 caracter. Indica el idioma en que se imprimira el PDF del comprobante. Valores Permitidos: 1 = Español, 2= Ingles |
| punto_venta | REQUERIDO | Campo numérico entero. Longitud máxima 5 digitos. |
| moneda | REQUERIDO | Campo alfanumérico de 3 Digitos según tabla de referencia de Monedas . |
| cotizacion | REQUERIDO | Número decimal con 3 lugares decimales. Representa el valor en pesos argentinos de una moneda extranjera. Se obtiene en tiempo real a través de nuestra API de cotización AFIP. Ejemplo: 15.20. Solo aplicable a monedas distintas al peso argentino. |
| numero | OPCIONAL | El numero del comprobante a generar. Campo numérico entero. Longitud máxima 8 digitos. La numeración será validada internamente previa generación del comprobante contra AFIP. Si el nro de comprobante NO es enviado, traeremos la próxima numeración . Ejemplo: 4567 |
| vencimiento | REQUERIDO | Campo fecha, formato esperado: dd/mm/aaaa. |
| periodo_facturado_desde | REQUERIDO | Campo fecha. Formato esperado: dd/mm/aaaa. Opcional solo para quienes facturen productos y asi lo indiquen en la configuración de su CUIT+punto de venta. Obligatorio para quienes facturen Servicios o Productos y Servicios. |
| periodo_facturado_hasta | REQUERIDO | Campo fecha. Formato esperado: dd/mm/aaaa. Opcional solo para quienes facturen productos y así lo indiquen en la configuración de su CUIT+punto de venta.Obligatorio para quienes facturen Servicios o Productos y Servicios. |
| rubro | REQUERIDO | Campo alfanumérico que no sale impreso en el pdf. Se utiliza para los reportes que brinda nuestra plataforma web y no es requerido por AFIP. Longitud máxima 255 caracteres. Indica el rubro al cual pertenecerá el comprobante. |
| rubro_grupo_contable | REQUERIDO | Campo alfanumérico que no sale impreso en el pdf. Se utiliza para los reportes que brinda nuestra plataforma web y no es requerido por AFIP/ARCA. Longitud máxima 255 caracteres. Indica el grupo contable al que pertenece el rubro. |
| abono | OPCIONAL (Solo disponible para ventas) | Campo alfabético, longitud máxima 1 caracter. Valores permitidos S (si) o N (no). Indica si el comprobante a generar es un abono recurrente. |
| abono_frecuencia | REQUERIDO SOLO SI ENVIA ABONO | Campo numerico sin decimales. Indica la frecuencia en meses con la que debe generarse la recurrencia del abono. |
| abono_hasta | REQUERIDO SOLO SI ENVIA ABONO | Campo fecha (mm/yyyy). Longitud maxima 7. Indica el mes y año hasta el cual debe generarse el abono recurrente. |
| abono_actualiza_precios | REQUERIDO SOLO SI ENVIA ABONO | Campo alfabético, longitud máxima 1 caracter. Valores permitidos S (si) o N (no). Indica si cada vez que se genera el abono, se actualiza los precios de los productos contra el precio actual de la lista de precios. |
| detalle | REQUERIDO | Lista de conceptos a facturar. Objeto JSON, según estructura que se detalla a continuación |
| fex | REQUERIDO PARA COMPROBANTES E | Solo para comprobantes de tipo E. Objeto JSON, según estructura detallada en: Factura electronica de exportacion". |
| bonificacion | OPCIONAL | Campo numérico positivo con 2 decimales. separador de decimales: punto. Indica el valor aplicado en concepto de bonificación sin IVA Ejemplo: 12.67. Tener en cuenta para el cálculo que la bonificación se aplica sobre el primer subtotal SIN IVA y se lo gravará con el importe de IVA que le corresponda. |
| leyenda_gral | OPCIONAL | Campo alfanumérico. Longitud máxima 500 caracteres. Contenido opcional. Es una leyenda general / observación comercial, que saldrá impresa en el bloque central del PDF, al final del último producto. Si queres que parte del texto salga en una linea nueva, agrega: #@# , si queres enviar el "%", en su lugar envía: #&#. Ejemplo: Aplica plan 12 cuotas, con un 10#&# de interes. |
| comentario | OPCIONAL | Campo alfanumerico, opcional. Longitud máxima: 255 caracteres. Éste campo no saldrá impreso en la factura. |
| tributos | SOLO SI APLICA | Objeto JSON, con la lista de percepciones y otros impuestos, según se detalla su estructura a continuación. |
| impuestos_internos | OPCIONAL | Si envias impuestos internos en cada uno de los items, debes Indicar el valor monetario correspondiente a la sumatoria los impuestos internos detallados en cada uno de los items que incluis. Campo numérico positivo con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
| impuestos_internos_base | OPCIONAL | Si envías impuestos internos en cada uno de los items, debes indicar la sumatoria de la base imponible sobre la cual se calcularon los impuestos internos. Campo numérico positivo con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
| impuestos_internos_alicuota | OPCIONAL | La alícuota sobre la cual se calcularon los impuestos internos de cada uno de los items que incluiste. Por cada comprobante se permite una única alícuota de impuestos internos. Campo numérico positivo con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
| total | REQUERIDO | Campo numérico positivo con 2 decimales. separador de decimales: punto. Indica el valor monetario de la sumatoria de conceptos incluyendo IVA e impuestos. Ejemplo: 12452.67 |
| comprobantes_asociados | SOLO PARA NC O ND | Lista de comprobantes asociados. Requerido únicamente para NC o ND de tipo A,B,C,M. Objeto JSON Según estructura que se detalla a continuación |
| rg_especiales | SOLO SI APLICA ALGUNA RG | Lista de datos adicionales requeridos por AFIP, según la RG a la que aplique el comprobante. Objeto JSON Según estructura que se detalla a continuación |
| external_reference | SOLO PARA VENTAS ASINCRÓNICAS | Dato alfanumérico de hasta 255 caracteres (solo se permiten letras, números, guión bajo y guión medio), que se utiliza para referenciar a éste comprobante, dentro de tu sistema. Es opcional, salvo que utilices los métodos de envió a la cola de procesamiento. No se realiza validación de éste campo, para verificar que el mismo no exista. |
| tags | OPCIONAL | Dato que no sale impreso en el PDF, solo para gestion interna ya que se visualiza en la consulta del comprobante desde la plataforma web. Objeto JSON, según estructura que se detalla a continuación. |
| datos_informativos | OPCIONAL | Objeto JSON, según estructura que se detalla a continuación. |
| NOMBRE DEL CAMPO | REQUERIDO? | INFO |
|---|---|---|
documento_tipo | REQUERIDO | Valores Permitidos: CUIT , DNI, PASAPORTE, OTRO Ejemplo: DNI |
documento_nro | REQUERIDO | Campo numérico, sin puntos ni guiones. Ejemplo: 30111222334 |
razon_social | REQUERIDO | Campo alfanumérico. Longitud máxima 255 caracteres. Ejemplo: Pirulo S.A |
email | OPCIONAL | Campo alfanumérico. Longitud máxima 255 caracteres. Máximo 15 direcciones separadas por coma. Ejemplo: tusfacturas@vousys.com |
domicilio | REQUERIDO | Campo alfanumérico. Longitud máxima 255 caracteres. Ejemplo: Av. Santa Fe 123 |
provincia | REQUERIDO | Campo numérico según tabla de referencia(*). Ejemplo: 2 |
envia_por_mail | REQUERIDO | Indica Si/No para el envio del comprobante por e-mail. Valores Permitidos: S , N Ejemplo: S |
condicion_pago | REQUERIDO | Campo numérico según tabla de referencia. Si envias la condición de pago "Otra" (214) se debe enviar obligatoriamente el campo condicion_pago_otra " con la descripción de dicha condición.
Éste dato informativo sale impreso en el PDF |
| condicion_pago_otra | OPCIONAL | Campo alfanumérico. Longitud máxima 100 caracteres. Ejemplo: Cobrado en ventanilla. |
condicion_iva | REQUERIDO | Campo numérico que indica la condición de iva, según tabla de referencia Condiciones ante el IVAValores Permitidos: CF, RI, M, E Ejemplo: RI |
| condicion_iva_operacion | OPCIONAL | Éste campo entra en vigencia a partir del 15/04/2025 mediante la RG 5616/2024 de AFIP/ARCA. Deberá consignarse la condición frente al IVA en que se realiza la operación. De no enviarse éste campo se enviará lo que se especifique en el campo "condicion_iva". |
| codigo | REQUERIDO | Campo alfanúmerico de hasta 50 caracteres para referenciar a ese cliente. Éste dato debería ser único dentro de tu plataforma pero TusFacturasAPP no realiza dicha verificación. Si existiera +1 con el mismo código podrías sufrir problemas al actualizar los datos. Ejemplo: "CLI2394" |
| rg5329 | REQUERIDO | Este campo te permite indicar si tu cliente es pasible de percepción IVA RG5329. Valores posibles: "S" o "N". |
| reclama_deuda | OPCIONAL | Indica SI/No para el envio del recordatorio de pago al cliente. Opciones validas: "S" o "N" |
| reclama_deuda_dias | OPCIONAL | En caso de haber habilitado el recordatorio de pago atrasado, se debe indicar cuantos dias pasados la fecha de vencimiento del comprobante se desea comenzar a recordar el pago adeudado. Se espera recibir un valor numerico indicando el número de días) |
| reclama_deuda_repite_dias | OPCIONAL | En caso de haber habilitado del recordatorio de pago atrasado, se debe indicar la frecuencia de cada cuantos dias se desea volver a recordar. Se espera recibir un valor numérico, indicando el número de días. |
| nombre_fantasia | OPCIONAL | Campo alfanumérico. Longitud máxima 255 caracteres. Ejemplo: Pirulo y Amigos |
| NOMBRE DEL CAMPO | REQUERIDO? | |
|---|---|---|
cantidad | REQUERIDO | Campo numérico positivo con 2 decimales. Separador de decimales: punto. Ejemplo: 1.50 |
afecta_stock | REQUERIDO | Campo alfanumérico de 1 posición. Valores posibles: "S" (si), "N" (no) Ejemplo: S |
producto | REQUERIDO | Según estructura de producto que se detalla a continuación. |
leyenda | OPCIONAL | Campo alfanumérico. Longitud máxima 1000 caracteres. Contenido opcional. Será una descripción que acompañe al producto. Ejemplo: Blanca, cepillada |
| bonificacion_porcentaje | OPCIONAL | Si se ha aplicado un porcentaje de descuento sobre éste concepto, debe ser enviado. Es un campo númerico positivo con 2 decimales. El separador de decimales esperado es el punto. Ej: 25 |
| incluir_lista_precios_venta | REQUERIDO SOLO PARA COMPRAS | Si estas enviando una compra, podes indicar que éste producto que compraste, se incorpore como un producto mas a los de tu lista de precios de venta. De esa manera podrás gestionar el stock tanto por la API como por la plataforma web. Valores esperados: "S" o "N" Ej: "S" |
{
"descripcion": "HUEVOS",
"unidad_bulto": "30",
"lista_precios": "MAPPLETS",
"codigo": "MPH",
"precio_unitario_sin_iva":"50",
"alicuota": "10.5",
"unidad_medida": "7",
"impuestos_internos_alicuota": 0,
"actualiza_precio": "N",
"rg5329": "N"
}
| NOMBRE DEL CAMPO | REQUERIDO? | INFO |
|---|---|---|
descripcion | REQUERIDO | Campo alfanumérico. Longitud máxima 255 caracteres y mínima de 4 caracteres. Ejemplo: Papa blanca |
unidad_bulto | REQUERIDO | Campo numérico entero requerido. Indica la cantidad de unidades que componen un bulto. Éste dato se usa únicamente para los remitos para calcular la cantidad de bultos. Valor minimo esperado: 1 Ejemplo: 12 |
lista_precios | REQUERIDO | Campo alfanumérico. Longitud mínima de 4 caracteres y máxima 255 caracteres. Nombre de la lista de precios a la cual pertenece. No saldrá impreso en la factura pero es requerido. Ejemplo: Verdura Orgánica |
codigo | REQUERIDO | Campo alfanúmerico de hasta 50 caracteres para referenciar a ese producto. Éste dato debería ser único dentro de tu plataforma pero TusFacturasAPP no realiza dicha verificación. Si existiera +1 con el mismo código podrías sufrir problemas al actualizar los datos. Ejemplo: ABX780 |
precio_unitario_sin_iva | REQUERIDO | Campo numérico positivo con 2 decimales. separador de decimales: punto Ejemplo: 645.67 |
alicuota | REQUERIDO | Indica la alícuota de IVA con la que grava ese producto. Valores Permitidos: 27, 21 , 10.5 , 0 , -1 ( para exento), -2 (no gravados) |
unidad_medida | REQUERIDO | Campo numérico que indica la unidad de medida, según tabla de referencia Unidades de Medida(**). Ejemplo: 7 |
actualiza_precio | REQUERIDO | Indica si se actualiza el precio del producto y sus datos adicionales (como ser la unidad de medida, código, unidades por bulto y otros datos adicionales), tomando como valor de referencia,la información enviada en el comprobante. Campo Alfabético, de 1 carácter. Valores permitidos: S (si) N (no). Ejemplo: S |
impuestos_internos_alicuota | OPCIONAL | La alícuota que se cobra en concepto de impuestos internos para éste producto. Se permite una única alícuota por comprobante. Campo numérico positivo, con 2 decimales. ej: 10.5 |
| rg5329 | REQUERIDO | Este campo te permite indicar si tu producto percibe la percepción IVA RG5329. Valores posibles: "S" o "N". Si envias el valor en "S", debes enviar el campo "actualiza_precio" tambien en "S". Conocé cuando aplicar la RG5329 desde aquí |
"tributos": [
{
"tipo" : 7,
"regimen": 22,
"base_imponible": 2000,
"alicuota": 20,
"total": 400
},
{
"tipo" : 6,
"regimen": 3,
"base_imponible": 1000,
"alicuota": 3,
"total": 30
},
{
"tipo" : 6,
"regimen": 3,
"base_imponible": 1000,
"alicuota": 1.5,
"total": 15
},
{
"tipo" : 6,
"regimen": 1,
"base_imponible": 1000,
"alicuota": 10,
"total": 100
}
],
| nombre del campo | REQUERIDO | Valores esperados |
|---|---|---|
| tipo | REQUERIDO | Campo numérico, según tabla de referencia /pages/-LCQu5FjyK86Bd-lOR82#bloque-tributos-greater-than-tipos-de-percepcion-a-aplicar |
| regimen | REQUERIDO | Campo numérico, según tabla de referencia: /pages/-LCQu5FjyK86Bd-lOR82#bloque-tributos-greater-than-regimen-de-percepcion |
| base_imponible | REQUERIDO | Campo numérico positivo con hasta 2 decimales, donde se indica la base imponible sobre la cual se aplica la percepción. |
| alicuota | REQUERIDO | Campo numérico con hasta 2 decimales, donde se indica la alícuota de dicha percepción |
| total | REQUERIDO | Campo numérico positivo de hasta 2 decimales, con el importe total de la percepción a aplicar. |
| REQUERIDO | ||
|---|---|---|
id | REQUERIDO | Campo númerico. Valores esperados según Tabla de referencia: Datos Opcionales para RG Especiales |
valor | REQUERIDO | Campo alfanumérico. |
| Nombre del campo | REQUERIDO | Detalle |
|---|---|---|
| formas_pago | REQUERIDO | array con multiples items, según estructura que se detalla a continuación |
| total | REQUERIDO | Campo numérico positivo con 2 decimales. separador de decimales: punto Ejemplo: 645.67 |
Campo numérico positivo con 2 decimales. separador de decimales: punto
Ejemplo: 645.67
| Nombre del campo | Requerido | Detalle |
|---|---|---|
| OPCIONAL | Éste dato entra en vigencia el 15/04/2025 según la RG5616/2024 y deberá enviarse "N" para indicar "No informa" o "S" para indicar "Si". En caso de enviarse con el valor "S", la moneda enviada debe ser diferente al Peso Argentino y la cotización debe ser la oficial provista por AFIP/ARCA desde éste método |