API Factura electrónica AFIP - Comprobantes: Facturación individual de nueva venta
Poder utilizar la API debes estar registrado.
Mientras estés en etapa de testing, configurá tu CUIT con un punto de venta irreal (Ej: 679), y usa ese CUIT de prueba para facturar, la respuesta que recibirás es la misma que si facturas contra AFIP, solo que los campos CAE y Vencimiento del CAE te retornaran vacios. Una vez que hayas probado todos los métodos, crea el nuevo CUIT+punto de venta y lo enlazas con AFIP.
Ten en cuenta que al registrarte, te asignamos un plan gratuito que te permite emitir 5 comprobantes por mes y una vez vencido tu período de prueba, debes contratar algún plan API de los que tenemos disponibles aquí .
En caso que requieras 20 días con un plan free para el desarrollo, contáctanos a tusfacturas@vousys.com
postNuevo comprobante de Venta
JSON{"error": "N","errores": [ ""],"rta": "El comprobante NOTA DE DEBITO B 0002-00000006 (MI CUIT) se ha guardado correctamente","cae": "65301278726386 ","requiere_fec": "NO ","vencimiento_cae":"07\/08\/2015","vencimiento_pago":"27\/08\/2015","comprobante_pdf_url": "https://www.dominio.com/url","afip_codigo_barras" : "12121212121006000300000000000000201811052 ","envio_x_mail": "S","comprobante_nro": "0000123","comprobante_tipo": "NOTA DE DEBITO B","envio_x_mail_direcciones":"direccion1@sudominio.com,direccion2@sudominio.com"}
Ten en cuenta a la hora de calcular el total, que las bonificaciones están gravadas con IVA
{"usertoken" : "jajajja8c8bf67c884e1405e26c03c85","apikey" : "9991","apitoken" : "kkakak208a17cdfc4e4741437baddaa6","cliente" :{ "documento_tipo": "DNI","documento_nro": "1292963535","razon_social": "Pirulo","email": "test@test.com","domicilio": "Av Sta Fe 123","provincia": "2","envia_por_mail": "S","condicion_pago": "214","condicion_pago_otra": "Cobrado en ventanilla","condicion_iva": "CF"},"comprobante": {"fecha": "28\/07\/2015","tipo": "NOTA DE DEBITO B","moneda": "DOL","idioma": "1","cotizacion": "15.20","operacion": "V","punto_venta": "2","numero": "6","periodo_facturado_desde": "27\/07\/2015","periodo_facturado_hasta": "30\/07\/2015","vencimiento": "30\/08\/2015","rubro": "Servicios web","rubro_grupo_contable": "servicios","abono": "S","abono_frecuencia": "2","abono_hasta":"10/2019","abono_actualiza_precios": "N","detalle":[{"cantidad":"1","afecta_stock": "N","bonificacion_porcentaje": "0","producto":{"descripcion": "PAPAS","unidad_bulto": "10","lista_precios": "MI LISTA DE PRECIOS","codigo": "","precio_unitario_sin_iva":"100.45","alicuota": "21","impuestos_internos_alicuota": 0,"unidad_medida": "7","actualiza_precio": "S"},"leyenda":"blanca, cepillada"},{"cantidad":"1.5","bonificacion_porcentaje": "0","afecta_stock": "N","producto":{"descripcion": "HUEVOS","unidad_bulto": "30","lista_precios": "MAPPLETS","codigo": "MPH","precio_unitario_sin_iva":"50","alicuota": "10.5","impuestos_internos_alicuota": 0,"unidad_medida": "7","actualiza_precio": "N"},"leyenda":""},{"cantidad":"2","bonificacion_porcentaje": "0","afecta_stock": "S","producto":{"descripcion": "ZANAHORIA","unidad_bulto": "50","lista_precios": "MI LISTA DE PRECIOS","codigo": "ZNH1","precio_unitario_sin_iva":"200","alicuota": "21","impuestos_internos_alicuota": 0,"unidad_medida": "7"},"leyenda":""}],"rg_especiales":{ "regimen" : "RG 4004-E","datos" :[{"id" : 17,"valor" : "2"},{"id" : 1801,"valor" : "111111111111"},{"id" : 1802,"valor" : "PRUEBA"}]},"bonificacion": "120","leyenda_gral": "Segun Orden de compra III1333","comentario": "Factura correspondiente al servicio XX","percepciones_iibb": "0","percepciones_iibb_base": "0","percepciones_iibb_alicuota": "0","percepciones_iva": "0","percepciones_iva_base": "0","percepciones_iva_alicuota": "0","exentos": "0","impuestos_internos": "0","impuestos_internos_base": "0","impuestos_internos_alicuota": "0","total": "543.22"}}
Para poder generar el comprobante, debes enviar de todos los datos según se informa a continuación.
JSON"comprobante": {"fecha": "28\/07\/2015","tipo": "NOTA DE DEBITO B","moneda": "DOL","idioma": "1","cotizacion": "15.20","operacion": "V","punto_venta": "2","numero": "6","periodo_facturado_desde": "27\/07\/2015","periodo_facturado_hasta": "30\/07\/2015","vencimiento": "30\/08\/2015","rubro": "Servicios web","rubro_grupo_contable": "servicios","abono": "S","abono_frecuencia": "2","abono_hasta":"10/2019","abono_actualiza_precios": "N","detalle":[{"cantidad":"1","bonificacion_porcentaje": "0","afecta_stock": "N","producto":{"descripcion": "PAPAS","unidad_bulto": "10","lista_precios": "MI LISTA DE PRECIOS","codigo": "","precio_unitario_sin_iva":"100.45","alicuota": "21","unidad_medida": "7","impuestos_internos_alicuota": 0,"actualiza_precio": "S"},"leyenda":"blanca, cepillada"},{"cantidad":"1.5","afecta_stock": "N","bonificacion_porcentaje": "0","producto":{"descripcion": "HUEVOS","unidad_bulto": "30","lista_precios": "MAPPLETS","codigo": "MPH","precio_unitario_sin_iva":"50","alicuota": "10.5","impuestos_internos_alicuota": 0,"unidad_medida": "7","actualiza_precio": "N"},"leyenda":""},{"cantidad":"2","afecta_stock": "S","bonificacion_porcentaje": "0","producto":{"descripcion": "ZANAHORIA","unidad_bulto": "50","lista_precios": "MI LISTA DE PRECIOS","codigo": "ZNH1","precio_unitario_sin_iva":"200","alicuota": "21","impuestos_internos_alicuota": 0,"unidad_medida": "7"},"leyenda":""}],"bonificacion": "120","leyenda_gral": "Segun Orden de compra III1333","comentario": "Factura correspondiente al servicio XX","percepciones_iibb": "0","percepciones_iva": "0","exentos": "0","impuestos_internos": "0","total": "543.22","comprobantes_asociados": []}
Importante: TusFacturas.app NO válida que la sumatoria de los ítems que estas enviando para facturar se correspondan con los totales. Es responsabilidad del cliente corroborar y validar éstos datos.
Recordá que AFIP recibe únicamente totales, no el detalle de los items que facturas ya que para los comprobantes de tipo "A" , "B" , "C" y "M" , Factura de crédito electrónica , TusFacturas.app utiliza el método de facturación mediante webservice AFIP "WSFEv1" ( Factura electrónica sin detalle de productos ).
Nombre del campo | Requerido | Comentarios |
fecha | SI | Campo fecha. Para facturación afip deberá ser la fecha del día. Formato esperado: dd/mm/aaaa. Ejemplo: 13/05/2018 |
tipo | SI | Campo alfabético según tabla de referencia de Tipos de comprobantes. |
operacion | SI | 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 | SI | 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 | SI | Campo numérico entero. Longitud máxima 5 digitos. |
moneda | SI | Campo alfanumérico de 3 Digitos según tabla de referencia de Monedas . |
cotizacion | SI | Campo numérico con 2 decimales. Puede obtener la cotización del día según AFIP desde nuestro método de consulta de cotización Ejemplo: 15.20 |
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 | OPCIONAL | Campo fecha, formato esperado: dd/mm/aaaa. Si no se envía la fecha de vencimiento del pago, se calculará en base a la condición de pago del cliente, contra la fecha del comprobante. |
periodo_facturado_desde | SI | 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 | SI | 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 | SI | Campo alfanumérico. Longitud máxima 255 caracteres. Indica el rubro al cual pertenecerá el comprobante. Ésta información no saldrá impresa en el comprobante. |
rubro_grupo_contable | SI | Campo alfanumérico. Longitud máxima 255 caracteres. Indica el grupo contable al que pertenece el rubro. Ésta información no saldrá impresa en el comprobante. |
abono | OPCIONAL | 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 | SI | 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. Según estructura detallada en: Factura electronica de exportacion". |
bonificacion | OPCIONAL | Campo numérico 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 255 caracteres. Contenido opcional. Es una leyenda general que saldrá impresa en el bloque central de productos del comprobante Ejemplo: Aplica plan 12 cuotas sin interes. |
comentario | OPCIONAL | Campo alfanumerico, opcional. Longitud máxima: 255 caracteres. Éste campo no saldrá impreso en la factura. |
percepciones_iibb | OPCIONAL | Campo numérico con 2 decimales. separador de decimales: punto. Indica el valor monetario de la percepción de ingresos brutos realizada Ejemplo: 142.67 |
percepciones_iibb_base | OPCIONAL | La base imponible sobre la cual se calculo la percepción. Campo numérico con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
percepciones_iibb_alicuota | OPCIONAL | La alícuota sobre la cual se calculo la percepción. Campo numérico con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
percepciones_iva | OPCIONAL | Campo numérico con 2 decimales. separador de decimales: punto. Indica el valor monetario de la percepción de IVA realizada Ejemplo: 42.67 |
percepciones_iva_base | OPCIONAL | La base imponible sobre la cual se calculo la percepción. Campo numérico con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
percepciones_iva_alicuota | OPCIONAL | La alícuota sobre la cual se calculo la percepción. Campo numérico con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
impuestos_internos | OPCIONAL | Indica el valor monetario correspondiente a los impuestos internos. Campo numérico con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
impuestos_internos_base | OPCIONAL | La base imponible sobre la cual se calcularon los impuestos internos. Campo numérico con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
impuestos_internos_alicuota | OPCIONAL | La alícuota sobre la cual se calculo la percepción. Campo numérico con 2 decimales. separador de decimales: punto. Ejemplo: 42.67 |
exentos | OPCIONAL | Campo numérico con 2 decimales. separador de decimales: punto. Indica el valor monetario en concepto de exentos. Solo para comprobantes A y M Ejemplo: 72.67 |
total | SI | Campo numérico 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 | SEGUN CORRESPONDA | 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 | SEGUN CORRESPONDA | 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 |
Si querés que el comprobante tenga una fecha de vencimiento de pago particular, enviala en el campo "vencimiento".
Para poder generar el comprobante, debes enviar un detalle de todos los datos del cliente según se informa a continuación.
{"documento_tipo": "DNI","documento_nro": "1292963535","razon_social": "Pirulo","email": "test@test.com","domicilio": "Av Sta Fe 123","provincia": "2","envia_por_mail": "S","condicion_pago": "214","condicion_pago_otra": "Cobrado en ventanilla","condicion_iva": "CF"}
Si el cliente ya existia en la base de datos de www.tusfacturas.app será actualizado con los nuevos datos, salvo Tipo y Nro de documento y condicion ante el IVA.
Ten en cuenta que al enviar la condición de pago "otra" (codigo 214) , se debe enviar obligatoriamente el campo condicion_pago_otra "con la descripción de la misma.
Para casos de clientes del exterior, que posean pasaporte, ten en cuenta que AFIP solo permite el envío de números en el campo de documento_nro.
| Valores Permitidos: CUIT , DNI, PASAPORTE, OTRO Ejemplo: DNI |
| Campo numérico, sin puntos ni guiones. Ejemplo: 30111222334 |
| Campo alfanumérico. Longitud máxima 255 caracteres. Ejemplo: Pirulo S.A |
| Campo alfanumérico. Longitud máxima 255 caracteres. Ejemplo: tusfacturas@vousys.com |
| Campo alfanumérico. Longitud máxima 255 caracteres. Ejemplo: Av. Santa Fe 123 |
| Campo numérico según tabla de referencia(*). Ejemplo: 2 |
| Indica Si/No para el envio del comprobante por e-mail. Valores Permitidos: S , N Ejemplo: S |
| Campo numérico según tabla de referencia Ejemplo: 211 |
condicion_pago_otra | Campo alfanumerico. Longitud máxima 100 caracteres. Ejemplo: Cobrado en ventanilla. |
| Campo numérico que indica la condicion de iva, según tabla de referencia Condiciones ante el IVA(**). Valores Permitidos: CF, RI, M, E Ejemplo: RI |
El detalle de conceptos se compone de una lista de cada uno de los productos que vas a facturar.
Recuerda que debes enviar una lista (array) de conceptos. El máximo de conceptos permitidos por comprobante es de 100.
La estructura de cada concepto a enviar es la siguiente:
JSON{"cantidad": "1.5","afecta_stock": "N","bonificacion_porcentaje": "0","producto": {"descripcion": "HUEVOS","unidad_bulto": "30","lista_precios": "MAPPLETS","codigo": "MPH","precio_unitario_sin_iva": "50","impuestos_internos_alicuota": 0,"alicuota": "10.5","unidad_medida": "7","actualiza_precio":"S"},"leyenda": ""}
Los campos que debes enviar son los siguientes:
| Campo numérico con 2 decimales. Separador de decimales: punto. Ejemplo: 1.50 |
| Campo alfanumérico de 1 posición. Valores posibles: "S" (si), "N" (no) Ejemplo: S |
| Según estructura de producto |
| Campo alfanumérico. Longitud máxima 100 caracteres. Contenido opcional. Será una descripción que acompañe al producto. Ejemplo: Blanca, cepillada |
bonificacion_porcentaje | Si se ha aplicado un porcentaje de descuento sobre éste concepto, debe ser enviado. Es un campo númerico con 2 decimales. El separador de decimales esperado es el punto. Ej: 25 |
| |
| |
Si el producto ya existia en la base de datos de nuestra plataforma, para la lista de precios indicada, será actualizado con los nuevos datos.
{"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"}
Los campos que debes enviar son los siguientes:
| Campo alfanumérico. Longitud máxima 255 caracteres. Ejemplo: Papa blanca |
| Campo numérico entero requerido. Indica la cantidad de unidades que componen un bulto. Valor minimo esperado: 1 Ejemplo: 12 |
| Campo alfanumérico. Longitud 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 |
| Campo alfanumérico. Longitud máxima 10 caracteres. campo Opcional Ejemplo: ABX780 |
| Campo numérico con 2 decimales. separador de decimales: punto Ejemplo: 645.67 |
| Indica la alicuota de IVA con la que grava ese producto. Valores Permitidos: 27, 21 , 10.5 , 0 , -1 ( para exento), -2 (no gravados) Ejemplo: 10.5 |
| Campo numérico que indica la unidad de medida, según tabla de referencia Unidades de Medida(**). Ejemplo: 7 |
| Indica si se actualiza el precio del producto, en la base productos, tomando como valor de referencia el enviado en el comprobante. Campo Alfabético, de 1 caracter. Valores permitidos: S (si) N (no). Ejemplo: S |
| La alícuota que se cobra en concepto de impuestos internos para éste producto. Campo numerico, con 2 decimales. ej: 10.5 |
| |
En caso que quieras reflejar en los comprobantes generados, un signo de porcentaje (%), deberás enviarlo en la descripción del producto de ésta manera: #&# , asi como si quisieras que parte de esa descripción del producto se imprima en otra linea, deberás enviar: #@#
Cada uno de los comprobantes asociados que disponga, deberán ser enviados dentro de un array, acorde a la estructura que se detalla a continuación para cada comprobante asociado.
Solo se deberán enviar los comprobantes asociados, cuando se emitan Notas de Débito o Notas de Crédito de tipo A, B, C, M y Comprobantes de tipo FCE. Éste campo es obligatorio en los campos mencionados.
{"tipo_comprobante" : "FACTURA A","punto_venta" : "145","numero" : 12313,"comprobante_fecha": "07/07/2019","cuit": 111111111}
Información de los campos a enviar:
| Campo alfabético. Valores esperados según tabla de tipos de comprobante. |
| Campo numérico entero. Longitud máxima 5 digitos. Ejemplo: 3 |
| Campo numérico entero. Longitud máxima 8 digitos. La numeración será validada internamente previa generación del comprobante. Ejemplo: 4567 |
| Campo numérico, sin puntos ni guiones. Es el CUIT del emisor del comprobante asociado. Ejemplo: 1111111111 |
| La fecha del comprobante en formato dd/mm/aaaa |
Según la RG a la que tu empresa aplique, se deberá enviar un array con los datos adicionales, según se especifican en la tabla de Datos adicionales para RG Especiales.
Ten en cuenta que solo podrás aplicar a un regimen por cada comprobante que emitas.
JSON"rg_especiales":{ "regimen" : "RG 4004-E","datos" :[{"id" : 18,"valor" : "PRUEBA "},{"id" : 19,"valor" : "PRUEBA (2) "}]}
Información de los campos a enviar en el array de "datos":
| Campo númerico. Valores esperados según Tabla de Datos Opcionales para RG Especiales |
| Campo alfanumérico. |
Ten en cuenta que TusFacturas NO realiza validaciones sobre éstos campos. Los realiza la propia AFIP en caso que corresponda.
Si uno de los items enviados posee el valor vacio, éste item no será procesado.
