Documentación de la API


Mediante nuestra API podrás conectar tu sistema de gestión actual, con nuestra plataforma para generar ( y luego consultar) de manera segura, comprobantes de venta y de compra , como así también utilizar todas las funcionalidades que te brinda nuestra plataforma web.
En la documentación encontrarás ejemplos escritos en PHP para que luego los adaptes a tu lenguaje; Si bien no te podemos brindar soporte de otros lenguajes, al ser los input y los output en formato JSON, podes conectarlo el lenguaje que mas te guste, teniendo a mano stackoverflow por si tenes dudas ;)
Importante! poder utilizar la API debes estar registrado y una vez vencido tu período de prueba, debes contratar algún plan API de los que tenemos disponibles aquí (No habilitado para el plan newbie).

Versión actual: API v2 ( Consultá la documentación de la API v1 Aqui )
Tipo de API: API Rest
Tipo de datos entrada y respuesta: JSON
Charset: UTF-8
Tipo de request : POST
URL : https://www.tusfacturas.com.ar/app/api/v2/estado_servicios/alertas
Probá la API : https://www.tusfacturas.com.ar/proba-la-api-factura-electronica-afip.html

Tené en cuenta éstas cosas:
1) Para procesar correctamente los campos, debes encodearlos con UTF-8.
2) Para probar el uso de nuestra API, utilizá tu cuenta de prueba. Si te quedas sin cupo, contactanos a tusfacturas@vousys.com y te lo ampliamos por unos dias
3) Cuando realices comprobantes AFIP Factura electrónica válida, tené en cuenta que cada request que hagas para generar comprobantes, debe tener una diferencia de tiempo de 2 minutos, ya que sino la misma AFIP te bloquea el CUIT por unos minutos.
4) Nuestra API ya ha sido implementada contra sistemas que trabajan en PHP, Visual basic 6.0 y Ruby, como asi tambien entornos AMAZON WS, servidores dedicados y servidores compartidos.

Probá la API aquí



Autenticación

Para poder conectar con nuestra api es necesario que declares la dirección IP desde la cual realizaras los requests y que obtengas el token de tu cuenta, junto con el código de la misma y el token de tu CUIT (usertoken).


apitoken Token de tu cuenta
Ejemplo:d26b8fe8c8bf67c884e1405e26c03c85
Obtenelo ingresando al menú "Mi Cuenta". Es un valor único generado automáticamente por nuestro sistema.
 
apikey Código de empresa
Ejemplo:1134
Podes obtenerlo ingresando al menú "Mi Cuenta".
 
usertoken Token del CUIT que va a facturar
Ejemplo:aa6b8fe8c8bf67c884e1405e26c03c85
Obtenelo ingresando al menú "CUITs" y entrando a consultar al registro en cuestion. Es un valor único generado automáticamente por nuestro sistema.


Errores HTTP

Errores de HTTP comunes que puede devolver:
401, 403: El acceso ha sido denegado
404: El recurso no existe
400: Entrada de datos invalida (query string, post, etc)
405: Método no permitido




Generación de comprobantes

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/facturacion/nuevo

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder generar un comprobante.


                        
                                {
                                    "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":       "30",
                                                        "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",
                                                    "rubro":                    "Servicios web",
                                                    "rubro_grupo_contable":     "servicios",
                                                    "detalle":
                                                                [
                                                                    {
                                                                        "cantidad":"1",
                                                                        "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"
                                                                                 },
                                                                        "leyenda":"blanca, cepillada"
                                                                    },


                                                                    {
                                                                        "cantidad":"1.5",
                                                                        "afecta_stock": "N",
                                                                        "producto":
                                                                                {"descripcion":     "HUEVOS",
                                                                                 "unidad_bulto":    "30",
                                                                                 "lista_precios":   "MAPPLETS",
                                                                                 "codigo":          "MPH",
                                                                                 "precio_unitario_sin_iva":"50",
                                                                                 "alicuota":      "10.5",
                                                                                 "unidad_medida": "7"
                                                                                 },
                                                                        "leyenda":""
                                                                    },

                                                                    {
                                                                        "cantidad":"2",
                                                                        "afecta_stock": "S",
                                                                        "producto":
                                                                                {"descripcion":     "ZANAHORIA",
                                                                                 "unidad_bulto":    "50",
                                                                                 "lista_precios":   "MI LISTA DE PRECIOS",
                                                                                 "codigo":          "ZNH1",
                                                                                 "precio_unitario_sin_iva":"200",
                                                                                 "alicuota":      "21",
                                                                                 "unidad_medida": "7"
                                                                                 },
                                                                        "leyenda":""
                                                                    }

                                                                ],
                                                    "bonificacion":             "120",
                                                    "leyenda_gral":             "bla bla bla",
                                                    "percepciones_iibb":        "0",
                                                    "percepciones_iva":         "0",
                                                    "exentos":                  "0",
                                                    "nogravados":               "0",
                                                    "impuestos_internos":       "0",
                                                    "total":                    "543.22"
                                            }
                                }



                      
                    

JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "rta":      "El comprobante NOTA DE DEBITO B 0002-00000006 (MI CUIT) se ha guardado correctamente",
                        "cae":      "65301278726386",
                        "vencimiento_cae":"07\/08\/2015",
                        "vencimiento_pago":"27\/08\/2015",
                        "comprobante_pdf_url": "https://www.tusfacturas.com.ar/app/comprobantes/30111111111-1292963535-0002-00000006.pdf"
                    }

                      
                    

JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                        {
                            "error":     "S"
                            "errores":
                                        [
                                            "Ya existe un comprobante con el nro 0002-00000003. El proximo numero disponible es: 0002-00000007",
                                            "El punto de venta es invalido",
                                        ]
                        }

                      
                    


Variables para el array de "Cliente"

Si el cliente ya existia en la base de datos de www.tusfacturas.com.ar será actualizado con los nuevos datos, salvo Tipo y Nro de documento y condicion ante el IVA


documento_tipo Valores Permitidos: CUIT , DNI
Ejemplo: DNI
 
documento_nro Campo numérico, sin puntos ni guiones.
Ejemplo: 30111222334
 
razon_social Campo alfanumérico. Longitud máxima 255 caracteres.
Ejemplo: Pirulo S.A
 
email Campo alfanumérico. Longitud máxima 255 caracteres.
Ejemplo: tusfacturas@vousys.com
 
domicilio Campo alfanumérico. Longitud máxima 255 caracteres.
Ejemplo: Av. Santa Fe 123
 
provincia Campo numérico según tabla de referencia(*).
Ejemplo: 2
 
envia_por_mail Indica Si/No para el envio del comprobante por e-mail. Valores Permitidos: S , N
Ejemplo: S
 
condicion_pago Campo numérico que indica la cantidad de dias en los cuales vence el plazo de pago. Valores Permitidos: 0,30,60,90
Ejemplo: 30
 
condicion_iva 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



Variables para el array de "Producto" que compone un item del detalle

Si el producto ya existia en la base de datos de www.tusfacturas.com.ar para la lista de precios indicada, será actualizado con los nuevos datos


descripcion Campo alfanumérico. Longitud máxima 255 caracteres.
Ejemplo: Papa blanca
 
unidad_bulto Campo numérico entero. Indica la cantidad de unidades que componen un bulto.
Ejemplo: 12
 
lista_precios Campo alfanumérico. Longitud máxima 255 caracteres. Nombre de la lista de precios a la cual pertenece.
Ejemplo: Verdura Orgánica
 
codigo Campo alfanumérico. Longitud máxima 10 caracteres. campo Opcional
Ejemplo: ABX780
 
precio_unitario_sin_iva Campo numérico con 2 decimales. separador de decimales: punto
Ejemplo: 645.67
 
alicuota Indica la alicuota de IVA con la que grava ese producto. Valores Permitidos: 21 , 10.5
Ejemplo: 10.5
 
unidad_medida Campo numérico que indica la unidad de medida, según tabla de referencia Unidades de Medida(**).
Ejemplo: 7



Variables para el array de "Item de detalle" que componen al comprobante


cantidad Campo numérico con 2 decimales. Separador de decimales: punto.
Ejemplo: 1.50
 
afecta_stock Campo alfanumérico de 1 posición. Valores posibles: "S" (si), "N" (no)
Ejemplo: S
 
producto Según array detallado previamente en el apartado array de "Producto".
 
leyenda Campo alfanumérico. Longitud máxima 100 caracteres. Contenido opcional. Será una descripción que acompañe al producto.
Ejemplo: Blanca, cepillada


Variables para el array de "Factura electronica de exportacion - FEX" que componen al comprobante (Solo para comprobantes de tipo E)


 
tipo_exportacion Campo numérico. Longitud 1 caracter. Valores esperados:
1= Exportación definitiva de bienes
2= Servicios
4= Otros.
Ejemplo: 2
 
permisos_tiene Campo alfabético. Longitud 1 caracter. Indica si se posee documento aduanero de exportación (permiso de embarque). Valores esperados:
S= Si posee
N= No posee
(vacio)= No especifica
Ejemplo: S
 
permisos Solo deberán ser enviados los permisos cuando el campo permisos_tiene sea igual a "S". Valores a enviar según array detallado posteriormente en el apartado array de "Permisos de exportacion".
 
pais_comprobante_id Campo numérico. Según tabla de referencia Paises AFIP (**)
Ejemplo: 123
 
forma_pago_leyenda Campo alfanumérico. Descripción adicional de la forma de pago
Ejemplo: Favor depositar en cuenta XXXXX
 
cliente_pais_cuit Campo numérico. Según tabla de referencia CUIT Pais AFIP (**)
Ejemplo: 51600004380
 
incoterms_tipo_id Campo alfabético Incoterms – Cláusula de Venta. Según tabla de referencia Incoterms (**)
Ejemplo: EXW
 
incoterms_nro Campo alfanumérico - Información complementaria del incoterm
Ejemplo: Texto dic.
 
comprobantes_asociados Se deberá informar el/los comprobante/s asociados solamente si el comprobante que se está autorizando corresponde a una Nota de Débito o Nota de Crédito. Según array detallado posteriormente en el apartado array de "Comprobantes asociados".


Variables para el array "Permisos" perteneciente a "Factura electronica de exportacion - FEX" (Solo para comprobantes de tipo E)


Solo deberán ser enviados los permisos cuando el campo permisos_tiene sea igual a "S"

 
codigo_despacho Campo alfanumérico. Longitud 16 caracteres. Deberá ser un permiso válido, formato 99999AAXX999999A (donde XX podrán ser números o letras).
 
pais_destino_id Campo numérico. Según tabla de referencia Paises AFIP (**)
Ejemplo: 123


Variables para el array "Comprobantes asociados" perteneciente a "Factura electronica de exportacion - FEX" (Solo para comprobantes de tipo E)


Solo deberán ser enviados los comprobantes asociados, cuando el campo exportacion_tipo sea igual a "1"

 
tipo_comprobante Campo alfabético. Valores esperados: "FACTURA E", "NOTA DE DEBITO E", "NOTA DE CREDITO E"
 
punto_venta Campo numérico entero. Longitud máxima 4 digitos.
Ejemplo: 3
 
numero Campo numérico entero. Longitud máxima 8 digitos. La numeración será validada internamente previa generación del comprobante.
Ejemplo: 4567
CUIT Campo numérico, sin puntos ni guiones.
Ejemplo: 30111222334


Variables para el comprobante


fecha Campo fecha. Para facturación afip deberá ser la fecha del día. Formato esperado: dd/mm/aaaa.
Ejemplo: 19/04/2018
 
tipo Campo alfabético según tabla de referencia de Tipos de comprobantes(***).
Ejemplo: FACTURA B
 
operacion 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 Campo numérico. Longitud 1 caracter. Indica el idioma en que se imprimira el PDF del comprobante.
Valores Permitidos: 1 = Español, 2= Ingles
Ejemplo: 1
 
punto_venta Campo numérico entero. Longitud máxima 4 digitos.
Ejemplo: 3
 
moneda Campo alfanumérico de 3 Digitos según tabla de referencia de Monedas .
Ejemplo: 3
 
cotizacion 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 Campo numérico entero. Longitud máxima 8 digitos. La numeración será validada internamente previa generación del comprobante.
Ejemplo: 4567
 
periodo_facturado_desde Campo fecha. Contenido opcional. Formato esperado: dd/mm/aaaa.
Ejemplo: 19/04/2018
 
periodo_facturado_hasta Campo fecha. Contenido opcional. Formato esperado: dd/mm/aaaa.
Ejemplo: 19/04/2018
 
rubro 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.
Ejemplo: Servicios
 
rubro_grupo_contable 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.
Ejemplo: Servicios
 
detalle Según array detallado previamente en el apartado array de "Item de detalle".
 
fex Solo para comprobantes de tipo E. Según array detallado previamente en el apartado array de Factura electronica de exportacion - FEX ".
 
bonificacion 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 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.
 
percepciones_iibb 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_iva Campo numérico con 2 decimales. separador de decimales: punto. Indica el valor monetario de la percepción de IVA realizada
Ejemplo: 42.67
 
exentos 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
 
nogravados Campo numérico con 2 decimales. separador de decimales: punto. Indica el valor monetario en concepto de no gravados. Solo para comprobantes A y M
Ejemplo: 62.67
 
impuestos_internos Campo numérico con 2 decimales. separador de decimales: punto. Indica el valor monetario en concepto de impuestos internos
Ejemplo: 2.67
 
total Campo numérico con 2 decimales. separador de decimales: punto. Indica el valor monetario de la sumatoria de conceptos
Ejemplo: 12452.67


Consulta de próxima numeración de comprobantes

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/facturacion/numeracion

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar la proxima numeracion de un tipo de comprobante.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6",
                            "comprobante":  {
                                            "tipo":                     "NOTA DE DEBITO B",
                                            "operacion":                "V",
                                            "punto_venta":              "2"
                                    }
                        }

                      
                    


Variables para el comprobante


 
tipo Campo numérico según tabla de referencia de Tipos de comprobantes(***).
Ejemplo: FACTURA B
 
operacion Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C).
Valores Permitidos: V, C
Ejemplo: V
 
punto_venta Campo numérico entero. Longitud máxima 4 digitos.
Ejemplo: 3




JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "rta":      "OK",
                        "comprobante":  {
                                        "tipo":                     "NOTA DE DEBITO B",
                                        "operacion":                "V",
                                        "punto_venta":              "2",
                                        "numero":                   "6"

                                }
                        }





                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "El punto de venta es invalido",
                                    ]
                    }

                      
                    


Consulta de comprobantes

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/facturacion/consulta

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar un comprobante.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6",
                            "comprobante":  {
                                            "tipo":                     "NOTA DE DEBITO B",
                                            "operacion":                "V",
                                            "punto_venta":              "2",
                                            "numero":                   "6"
                                    }
                        }

                      
                    


Variables para el comprobante


 
tipo Campo numérico según tabla de referencia de Tipos de comprobantes(***).
Ejemplo: FACTURA B
 
operacion Campo alfanumérico. Longitud 1 caracter. Indica si envia una factura de venta (V) o de compra (C).
Valores Permitidos: V, C
Ejemplo: V
 
punto_venta Campo numérico entero. Longitud máxima 4 digitos.
Ejemplo: 3
 
numero Campo numérico entero. Longitud máxima 8 digitos. La numeración será validada internamente previa generación del comprobante.
Ejemplo: 4567


JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "rta":      "OK",


                            "cliente"   :
                                            {   "documento_tipo":       "DNI",
                                                "documento_nro":        "1292963535",
                                                "razon_social":         "Pirulo",
                                                "email":                "test@test.com",
                                                "domicilio":            "Av Sta Fe 123"
                                            },

                            "comprobante":  {

                                            "fecha":                    "28\/07\/2015",
                                            "tipo":                     "NOTA DE DEBITO B",
                                            "moneda":                   "PES",
                                            "idioma" :               "1",
                                            "cotizacion":               "1",
                                            "operacion":                "V",
                                            "punto_venta":              "2",
                                            "numero":                   "6",
                                            "periodo_facturado_desde":  "27\/07\/2015",
                                            "periodo_facturado_hasta":  "30\/07\/2015",
                                            "rubro":                    "Servicios web",
                                            "rubro_grupo_contable":     "servicios",
                                            "detalle":
                                                        [
                                                            {
                                                                "cantidad":"1",
                                                                "producto":
                                                                        {"descripcion":     "PAPAS",
                                                                         "precio_unitario": "121.54", /* para comprobantes B ya se incluye el IVA en el precio */
                                                                         "alicuota":        "21",     /* La alícuota de IVA con la que gravaba el producto */
                                                                         "unidad_medida": "7",
                                                                         "precio_total":    "121.54" /* para comprobantes B ya se incluye el IVA en el precio */
                                                                         },
                                                                "leyenda":"blanca, cepillada"
                                                            },


                                                            {
                                                                "cantidad":"1.5",
                                                                "producto":
                                                                        {"descripcion":     "HUEVOS",
                                                                         "precio_unitario": "60.50",    /* para comprobantes B ya se incluye el IVA en el precio */
                                                                         "alicuota":        "21",     /* La alícuota de IVA con la que gravaba el producto */
                                                                         "unidad_medida": "7",
                                                                         "precio_total":    "90.75"     /* para comprobantes B ya se incluye el IVA en el precio */
                                                                         },
                                                                "leyenda":""
                                                            },

                                                            {
                                                                "cantidad":"2",
                                                                "producto":
                                                                        {"descripcion":     "ZANAHORIA",
                                                                         "precio_unitario": "242",    /* para comprobantes B ya se incluye el IVA en el precio */
                                                                         "alicuota":        "21",     /* La alícuota de IVA con la que gravaba el producto */
                                                                         "unidad_medida": "7",
                                                                         "precio_total":    "484"     /* para comprobantes B ya se incluye el IVA en el precio */
                                                                         },
                                                                "leyenda":""
                                                            },

                                                        ],
                                            "bonificacion":             "120",
                                            "subtotal_1":               "380.45",
                                            "iva_alicuota":             "21",
                                            "subtotal_2":               "75",
                                            "iva_alicuota_2":             "10.5",
                                            "leyenda_gral":             "bla bla bla",
                                            "percepciones_iibb":        "0",
                                            "percepciones_iva":         "0",
                                            "exentos":                  "0",
                                            "nogravados":               "0",
                                            "impuestos_internos":       "0",
                                            "total":                    "543.21",
                                            "cae":                      "65301278726386",
                                            "vencimiento_cae":          "07\/08\/2015",
                                            "vencimiento_pago":         "27\/08\/2015",
                                            "comprobante_pdf_url":      "https://www.tusfacturas.com.ar/app/comprobantes/30111111111-1292963535-0002-00000006.pdf",

                                    }
                        }





                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "No existe el comprobante 0002-00000003.",
                                        "El punto de venta es invalido",
                                    ]
                    }

                      
                    


Estado de los servicios

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/estado_servicios/alertas

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar el estado de los servicios.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6",
                        }

                      
                    


JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

Facturación devolverá "OK" si los servicios de la AFIP funcionan bien o devolverá un mensaje de alerta con el detalle de la incidencia

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ],
                        "rta":          "OK",
                        "facturacion":  "OK",
                        "novedades":  "24\/03\/2016 | App M\u00f3vil - Actualizaci\u00f3nYa se encuentra disponible para Iphone\/Ipad , la version 2.1 de nuestra app m\u00f3vil.  Descargala! 17\/03\/2016 | Reclamo de deudas autom\u00e1tico: Ahora podes indicar la cantidad de dias desde cuando el sistema empieza a reclamarle a tu cliente la deuda. Ingres\u00e1 a cliente y configuralo ",
                                 }
                        }





                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "Error 1",
                                    ]
                    }

                      
                    


Consulta de datos del contribuyente en padrón AFIP

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/clientes/afip-info

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar los datos en padrón AFIP Ésta información es obtenida al instante desde AFIP.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6",
                            "cliente":  {
                                            "documento_nro":    "30712293841",
                                            "documento_tipo":   "CUIT"
                                    }
                        }

                      
                    


Variables para enviar


documento_tipo Valores Permitidos: CUIT
Ejemplo: CUIT
 
documento_nro Campo numérico, sin puntos ni guiones.
Ejemplo: 30111222334




JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "rta":      "OK",

                        "info": {
                                "success":true,
                                "data":
                                    {
                                        "idPersona":11111111111111,
                                        "tipoClave":"CUIT",
                                        "nombre":"RAZON SOCIAL",
                                        "domicilioFiscal":
                                            {"direccion":"XXXXXXX 432",
                                            "localidad":"CASTELAR",
                                            "codPostal":"1712",
                                            "idProvincia":1},
                                        
                                        "impuestos":[20,10,25,30,103,211,217,218,301,353,767], 
                                    }
                                }
                            }



                    }
                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "El Nro de documento enviado es invalido",
                                    ]
                    }

                      
                    


Consulta de Cuenta corriente

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/clientes/cuenta-corriente

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar los datos en padrón AFIP Ésta información es obtenida al instante desde AFIP.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6",
                            "cliente":  {
                                            "documento_nro":    "30712293841",
                                            "documento_tipo":   "CUIT"
                                    }
                        }

                      
                    


Variables para enviar


documento_tipo Valores Permitidos: CUIT
Ejemplo: CUIT
 
documento_nro Campo numérico, sin puntos ni guiones.
Ejemplo: 30111222334




JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "rta":      "OK",

                        "resultados":[
                                        {   "fecha":"11\/05\/2017",
                                            "concepto":"FACTURA A 0002-00000001 (CUIT DE PRUEBA)",
                                            "debe":112.1,
                                            "haber":0,
                                            "resta_abonar_de_este_comprobante":112.1,
                                            "saldo":112.1
                                        },
                                        {
                                            "fecha":"11\/05\/2017",
                                            "concepto":"FACTURA A 0002-00000002 (CUIT DE PRUEBA)",
                                            "debe":112.1,
                                            "haber":0,
                                            "resta_abonar_de_este_comprobante":112.1,
                                            "saldo":224.2
                                        }
                                    ]

                            }



                    }
                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "El Nro de documento enviado es invalido",
                                    ]
                    }

                      
                    


Consulta de alícuotas en padrón ARBA sujetos Recaudación

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/clientes/arba-padron

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar la existencia de tu cliente en el padrón ARBA. Ésta información es obtenida mensualmente desde ARBA e importada en el perfil de cada cliente. El CUIT a consultar debe existir previamente en tu base de clientes.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6",
                            "cliente":  {
                                            "documento_nro":    "30712293841",
                                            "documento_tipo":   "CUIT"
                                    }
                        }

                      
                    


Variables para enviar


documento_tipo Valores Permitidos: CUIT , DNI
Ejemplo: DNI
 
documento_nro Campo numérico, sin puntos ni guiones.
Ejemplo: 30111222334




JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "rta":      "OK",
                        "alicuota_percepcion": 3,
                        "alicuota_retencion":  5,
                    }
                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "El Nro de documento enviado es invalido",
                                    ]
                    }

                      
                    


Consulta de unidades de medida para productos - AFIP

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/tablas_referencia/unidades_medida

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar la lista de unidades de medida disponibles.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6"
                        }

                      
                    


Variables para enviar


No se requieren adicionales a los datos de autenticación




JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "rta":      "OK",
                        "items":

                            [
                                {"id":"6","descripcion":"1000 kWh"},
                                {"id":"20","descripcion":"cent\u00edmetros"},
                                {"id":"27","descripcion":"cm c\u00fabicos"},
                                {"id":"48","descripcion":"curie"},
                                {"id":"30","descripcion":"dam c\u00fabicos"},
                                {"id":"9","descripcion":"docenas"}
                            ]
                    }
                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "No existen items disponibles",
                                    ]
                    }

                      
                    


Consulta de Paises - AFIP

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/tablas_referencia/paises

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar la lista de paises disponibles.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6"
                        }

                      
                    


JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "items":

                            [
                                {"id":"250","descripcion":"AAE Tierra del Fuego - ARGENTINA"},
                                {"id":"301","descripcion":"AFGANISTAN"}
                            ]
                    }
                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "No existen items disponibles",
                                    ]
                    }

                      
                    


Consulta de CUIT Pais - AFIP

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/tablas_referencia/cuit_pais

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar la lista de paises disponibles.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6"
                        }

                      
                    


JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "items":

                            [
                                {"id":"51600003015","descripcion":"AFGANISTAN - Otro tipo de Entidad"},
                                {"id":"50000003015","descripcion":"AFGANISTAN - Persona Fisica"}
                            ]
                    }
                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "No existen items disponibles",
                                    ]
                    }

                      
                    


Consulta de Incoterms

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/tablas_referencia/incoterms

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar la lista de tipos de incoterms disponibles.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6"
                        }

                      
                    


JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "items":

                            [
                                {"id":"51600003015","descripcion":"AFGANISTAN - Otro tipo de Entidad"},
                                {"id":"50000003015","descripcion":"AFGANISTAN - Persona Fisica"}
                            ]
                    }
                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "No existen items disponibles",
                                    ]
                    }

                      
                    


Consulta de Cotización del dolar

Tipo de datos: JSON
Charset: UTF-8
Tipo de request : POST
URL: https://www.tusfacturas.com.ar/app/api/v2/tablas_referencia/cotizacion

A continuación se muestran un ejemplo de la información en JSON que debe recibir la API para poder consultar con la cotización del dia según AFIP.


                        
                        {
                            "usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
                            "apikey"    :  "9991",
                            "apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6"
                        }

                      
                    


JSON de Respuesta OK

En caso de no existir errores, se devolverá la variable error con un valor "N" ademas de las variables que enunciamos a continuación.

                      
                    {
                        "error":     "N"
                        "errores":
                                    [
                                        ""
                                    ]

                        "cotizacion": "15.10"
                    }
                      
                    


JSON de Respuesta ERROR

En caso de existir errores, se devolverá la variable error con un valor "S" y dentro de la variable errores una lista con todos los errores detectados.


                      
                    {
                        "error":     "S"
                        "errores":
                                    [
                                        "No existen items disponibles",
                                    ]
                    }

                      
                    


Ejemplos (PHP)

Ejemplo de creación de comprobante C

                      


                    $facturacion_json= array(
                                    /** Datos de la empresa que solicita el comprobante **/
                                    "usertoken"         =>  "jajajja8c8bf67c884e1405e26c03c85",
                                    "apikey"            =>  "9991",
                                    "apitoken"          =>  "kkakak208a17cdfc4e4741437baddaa6",

                                    /** Datos del cliente al cual emitir el comprobante **/
                                    "cliente"       => array (
                                                                "documento_tipo"    =>  "DNI",
                                                                "documento_nro"     =>  str_pad(rand(),8,"0"),
                                                                "razon_social"      =>  "Pirulo",
                                                                "email"             =>  "test@test.com",
                                                                "domicilio"         =>  "Av Sta Fe 123 ",
                                                                "provincia"         =>  "2",
                                                                "envia_por_mail"    =>  "S",
                                                                "condicion_pago"    =>  "30",
                                                                "condicion_iva"     =>  "CF"
                                                            ) , // end cliente

                                    /** Datos del comprobante a emitir **/
                                    "comprobante"  => array (
                                                                "fecha"             =>  date("d/m/Y") ,
                                                                "tipo"              =>  "NOTA DE DEBITO C",
                                                                "operacion"         =>  "V",
                                                                "moneda"            => "DOL",
                                                                "idioma"            => 1,
                                                                "cotizacion"        => "15.20",
                                                                "punto_venta"       =>  "2",
                                                                "numero"            =>  "1",
                                                                "periodo_facturado_desde" =>"27/07/2015",
                                                                "periodo_facturado_hasta" =>"30/07/2015",
                                                                "rubro"             =>  "Servicios web",
                                                                "rubro_grupo_contable" =>  "servicios",
                                                                "detalle"           => array (
                                                                                        0   => array (
                                                                                                "cantidad"  => "1",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "PAPAS",
                                                                                                                        "unidad_bulto"  => "10",
                                                                                                                        "lista_precios" =>  "MI LISTA DE PRECIOS",
                                                                                                                        "codigo"        =>  "",
                                                                                                                        "precio_unitario_sin_iva" => "100.45" ,
                                                                                                                        "alicuota"              =>   "21" 
                                                                                                                        "unidad_medida" => "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  "blanca, cepillada"
                                                                                                    ), // end detalle item


                                                                                        1   => array (
                                                                                                "cantidad"  => "1.5",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "HUEVOS",
                                                                                                                        "unidad_bulto"  => "30",
                                                                                                                        "lista_precios" =>  "MAPPLETS",
                                                                                                                        "codigo"        =>  "MPH",
                                                                                                                        "precio_unitario_sin_iva"=> "50" ,
                                                                                                                        "alicuota"              =>   "21"
                                                                                                                        "unidad_medida" => "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  ""
                                                                                                    ), // end detalle item

                                                                                        2   => array (
                                                                                                "cantidad"  => "2",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "ZANAHORIA",
                                                                                                                        "unidad_bulto"  => "50",
                                                                                                                        "lista_precios" =>  "MI LISTA DE PRECIOS",
                                                                                                                        "codigo"        =>  "ZNH1",
                                                                                                                        "precio_unitario_sin_iva"=> "200"  ,
                                                                                                                        "alicuota"              =>   "21",  
                                                                                                                        "unidad_medida"=> "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  ""
                                                                                                    ), // end detalle item
                                                                                    ) , // end detalle
                                                            "bonificacion"              =>   "120",


                                                            "leyenda_gral"              =>  "bla bla bla",
                                                            "percepciones_iibb"         =>   "0",
                                                            "percepciones_iva"          =>   "0",
                                                            "exentos"                   =>   "0",
                                                            "nogravados"                =>   "0",
                                                            "impuestos_internos"        =>   "0",
                                                            "total"                     =>   "551.09",

                                                            ), //end comprobante

                                    );



                        // EJECUTO VIA CURL EL REQUEST PARA GENERAR EL COMPROBANTE

                            $url="https://www.tusfacturas.com.ar/app/api/v2/facturacion/nuevo" ;
                            $ch = curl_init( $url );
                            curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode($facturacion_json) );
                            curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
                            curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
                            $rta        = json_decode(curl_exec($ch));
                            curl_close($ch);


                        // MANEJO LA RESPUESTA
                            if ($rta->error == "N") {
                                echo '  CAE otorgado:'.$rta->cae.'

                                        Vto:'.$rta->vencimiento_cae.'

                                        Vto pago: '.$rta->vencimiento_pago.'

                                        PDF del comprobante: '.$rta->comprobante_pdf_url ;
                            }else{
                                echo 'Se han encontrado los siguientes errores:'.implode(',',$rta->errores );

                            }
                      
                    


Ejemplo de creación de comprobante E

                      


                    $facturacion_json= array(
                                    /** Datos de la empresa que solicita el comprobante **/
                                    "usertoken"         =>  "jajajja8c8bf67c884e1405e26c03c85",
                                    "apikey"            =>  "9991",
                                    "apitoken"          =>  "kkakak208a17cdfc4e4741437baddaa6",

                                    /** Datos del cliente al cual emitir el comprobante **/
                                    "cliente"       => array (
                                                                "documento_tipo"    =>  "DNI",
                                                                "documento_nro"     =>  str_pad(rand(),8,"0"),
                                                                "razon_social"      =>  "Pirulo",
                                                                "email"             =>  "test@test.com",
                                                                "domicilio"         =>  "Av Sta Fe 123 ",
                                                                "provincia"         =>  "2",
                                                                "envia_por_mail"    =>  "S",
                                                                "condicion_pago"    =>  "30",
                                                                "condicion_iva"     =>  "CF"
                                                            ) , // end cliente

                                    /** Datos del comprobante a emitir **/
                                    "comprobante"  => array (
                                                                "fecha"             =>  date("d/m/Y") ,
                                                                "tipo"              =>  "NOTA DE DEBITO C",
                                                                "operacion"         =>  "V",
                                                                "moneda"            => "DOL",
                                                                "idioma"            => 1,
                                                                "cotizacion"        => "15.20",
                                                                "punto_venta"       =>  "2",
                                                                "numero"            =>  "1",
                                                                "periodo_facturado_desde" =>"27/07/2015",
                                                                "periodo_facturado_hasta" =>"30/07/2015",
                                                                "rubro"             =>  "Servicios web",
                                                                "rubro_grupo_contable" =>  "servicios",
                                                                "detalle"           => array (
                                                                                        0   => array (
                                                                                                "cantidad"  => "1",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "PAPAS",
                                                                                                                        "unidad_bulto"  => "10",
                                                                                                                        "lista_precios" =>  "MI LISTA DE PRECIOS",
                                                                                                                        "codigo"        =>  "",
                                                                                                                        "precio_unitario_sin_iva" => "100.45" ,
                                                                                                                        "alicuota"              =>   "21" 
                                                                                                                        "unidad_medida" => "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  "blanca, cepillada"
                                                                                                    ), // end detalle item


                                                                                        1   => array (
                                                                                                "cantidad"  => "1.5",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "HUEVOS",
                                                                                                                        "unidad_bulto"  => "30",
                                                                                                                        "lista_precios" =>  "MAPPLETS",
                                                                                                                        "codigo"        =>  "MPH",
                                                                                                                        "precio_unitario_sin_iva"=> "50" ,
                                                                                                                        "alicuota"              =>   "21"
                                                                                                                        "unidad_medida" => "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  ""
                                                                                                    ), // end detalle item

                                                                                        2   => array (
                                                                                                "cantidad"  => "2",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "ZANAHORIA",
                                                                                                                        "unidad_bulto"  => "50",
                                                                                                                        "lista_precios" =>  "MI LISTA DE PRECIOS",
                                                                                                                        "codigo"        =>  "ZNH1",
                                                                                                                        "precio_unitario_sin_iva"=> "200"  ,
                                                                                                                        "alicuota"              =>   "21",  
                                                                                                                        "unidad_medida"=> "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  ""
                                                                                                    ), // end detalle item
                                                                                    ) , // end detalle


                                                            "fex" => array (
                                                                        "permisos_tiene"      => "S" ,
                                                                        "tipo_exportacion"    => "1",
                                                                        "pais_comprobante_id" => "123",
                                                                        "forma_pago_leyenda"  => "Payment via paypal 30 days ",
                                                                        "cliente_pais_cuit"   => "50000000016",
                                                                        "incoterms_tipo_id"   => "FOB",
                                                                        "incoterms_nro"       => "AAAAGGGGGGGGGGGAAA ",
                                                                        "permisos"    => array (
                                                                                            0 => array (
                                                                                                "codigo_despacho"  =>  "1234567890123456",
                                                                                                 "pais_destino_id" =>    "112"
                                                                                            ),

                                                                                            1=> array (
                                                                                                "codigo_despacho"   =>  "1234567890144456",
                                                                                                 "pais_destino_id"  =>    "123"
                                                                                            ),

                                                                                            2=> array (
                                                                                                "codigo_despacho"   =>    "4444567890123456",
                                                                                                 "pais_destino_id"  =>    "145"
                                                                                            )
                                                                                         )
                                                                      ),

                                                            "bonificacion"              =>   "120",
                                                            "leyenda_gral"              =>  "bla bla bla",
                                                            "percepciones_iibb"         =>   "0",
                                                            "percepciones_iva"          =>   "0",
                                                            "exentos"                   =>   "0",
                                                            "nogravados"                =>   "0",
                                                            "impuestos_internos"        =>   "0",
                                                            "total"                     =>   "551.09",

                                                            ), //end comprobante

                                    );



                        // EJECUTO VIA CURL EL REQUEST PARA GENERAR EL COMPROBANTE

                            $url="https://www.tusfacturas.com.ar/app/api/v2/facturacion/nuevo" ;
                            $ch = curl_init( $url );
                            curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode($facturacion_json) );
                            curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
                            curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
                            $rta        = json_decode(curl_exec($ch));
                            curl_close($ch);


                        // MANEJO LA RESPUESTA
                            if ($rta->error == "N") {
                                echo '  CAE otorgado:'.$rta->cae.'

                                        Vto:'.$rta->vencimiento_cae.'

                                        Vto pago: '.$rta->vencimiento_pago.'

                                        PDF del comprobante: '.$rta->comprobante_pdf_url ;
                            }else{
                                echo 'Se han encontrado los siguientes errores:'.implode(',',$rta->errores );

                            }
                      
                    


Ejemplo de creación de un comprobante B

                      


                    $facturacion_json= array(
                                    /** Datos de la empresa que solicita el comprobante **/
                                    "usertoken"         =>  "jajajja8c8bf67c884e1405e26c03c85",
                                    "apikey"            =>  "9991",
                                    "apitoken"          =>  "kkakak208a17cdfc4e4741437baddaa6",

                                    /** Datos del cliente al cual emitir el comprobante **/
                                    "cliente"       => array (
                                                                "documento_tipo"    =>  "DNI",
                                                                "documento_nro"     =>  str_pad(rand(),8,"0"),
                                                                "razon_social"      =>  "Pirulo",
                                                                "email"             =>  "test@test.com",
                                                                "domicilio"         =>  "Av Sta Fe 123 ",
                                                                "provincia"         =>  "2",
                                                                "envia_por_mail"    =>  "S",
                                                                "condicion_pago"    =>  "30",
                                                                "condicion_iva"     =>  "CF"
                                                            ) , // end cliente

                                    /** Datos del comprobante a emitir **/
                                    "comprobante"  => array (
                                                                "fecha"             =>  date("d/m/Y") ,
                                                                "tipo"              =>  "NOTA DE DEBITO B",
                                                                "operacion"         =>  "V",
                                                                "punto_venta"       =>  "2",
                                                                "moneda"            => "PES",
                                                                "idioma"         => 1,
                                                                "cotizacion"        => "1",
                                                                "numero"            =>  "1",
                                                                "periodo_facturado_desde" =>"27/07/2015",
                                                                "periodo_facturado_hasta" =>"30/07/2015",
                                                                "rubro"             =>  "Servicios web",
                                                                "rubro_grupo_contable" =>  "servicios",
                                                                "detalle"           => array (
                                                                                        0   => array (
                                                                                                "cantidad"  => "1",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "PAPAS",
                                                                                                                        "unidad_bulto"  => "10",
                                                                                                                        "lista_precios" =>  "MI LISTA DE PRECIOS",
                                                                                                                        "codigo"        =>  "",
                                                                                                                        "precio_unitario_sin_iva" => "100.45",
                                                                                                                        "alicuota"              =>   "21"
                                                                                                                        "unidad_medida" => "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  "blanca, cepillada"
                                                                                                    ), // end detalle item


                                                                                        1   => array (
                                                                                                "cantidad"  => "1.5",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "HUEVOS",
                                                                                                                        "unidad_bulto"  => "30",
                                                                                                                        "lista_precios" =>  "MAPPLETS",
                                                                                                                        "codigo"        =>  "MPH",
                                                                                                                        "precio_unitario_sin_iva"=> "50",
                                                                                                                        "alicuota"              =>   "21" 
                                                                                                                        "unidad_medida"=> "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  ""
                                                                                                    ), // end detalle item

                                                                                        2   => array (
                                                                                                "cantidad"  => "2",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "ZANAHORIA",
                                                                                                                        "unidad_bulto"  => "50",
                                                                                                                        "lista_precios" =>  "MI LISTA DE PRECIOS",
                                                                                                                        "codigo"        =>  "ZNH1",
                                                                                                                        "precio_unitario_sin_iva"=> "200",
                                                                                                                        "alicuota"              =>   "21",  
                                                                                                                        "unidad_medida" => "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  ""
                                                                                                    ), // end detalle item
                                                                                    ) , // end detalle
                                                            "bonificacion"              =>   "120",


                                                            "leyenda_gral"              =>  "bla bla bla",
                                                            "percepciones_iibb"         =>   "0",
                                                            "percepciones_iva"          =>   "0",
                                                            "exentos"                   =>   "0",
                                                            "nogravados"                =>   "0",
                                                            "impuestos_internos"        =>   "0",
                                                            "total"                     =>   "551.09",

                                                            ), //end comprobante

                                    );



                        // EJECUTO VIA CURL EL REQUEST PARA GENERAR EL COMPROBANTE

                            $url="https://www.tusfacturas.com.ar/app/api/v2/facturacion/nuevo" ;
                            $ch = curl_init( $url );
                            curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode($facturacion_json) );
                            curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
                            curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
                            $rta        = json_decode(curl_exec($ch));
                            curl_close($ch);


                        // MANEJO LA RESPUESTA
                            if ($rta->error == "N") {
                                echo '  CAE otorgado:'.$rta->cae.'

                                        Vto:'.$rta->vencimiento_cae.'

                                        Vto pago: '.$rta->vencimiento_pago.'

                                        PDF del comprobante: '.$rta->comprobante_pdf_url ;
                            }else{
                                echo 'Se han encontrado los siguientes errores:'.implode(',',$rta->errores );

                            }

                      
                    


Ejemplo de creación de un comprobante A

                      


                    $facturacion_json= array(
                                    /** Datos de la empresa que solicita el comprobante **/
                                    "usertoken"         =>  "jajajja8c8bf67c884e1405e26c03c85",
                                    "apikey"            =>  "9991",
                                    "apitoken"          =>  "kkakak208a17cdfc4e4741437baddaa6",

                                    /** Datos del cliente al cual emitir el comprobante **/
                                    "cliente"       => array (
                                                                "documento_tipo"    =>  "CUIT",
                                                                "documento_nro"     =>  "30712293841",
                                                                "razon_social"      =>  "VOUSYS SH",
                                                                "email"             =>  "test@test.com",
                                                                "domicilio"         =>  "Av Sta Fe 123 ",
                                                                "provincia"         =>  "2",
                                                                "envia_por_mail"    =>  "S",
                                                                "condicion_pago"    =>  "90",
                                                                "condicion_iva"     =>  "RI"
                                                            ) , // end cliente

                                    /** Datos del comprobante a emitir **/
                                    "comprobante"  => array (
                                                                "fecha"             =>  date("d/m/Y") ,
                                                                "tipo"              =>  "FACTURA A",
                                                                "operacion"         =>  "V",
                                                                "punto_venta"       =>  "2",
                                                                "numero"            =>  "6",
                                                                "periodo_facturado_desde" =>"27/07/2015",
                                                                "moneda"            => "PES",
                                                                "idioma"         => 1,
                                                                "cotizacion"        => "1",
                                                                "periodo_facturado_hasta" =>"30/07/2015",
                                                                "rubro"             =>  "Servicios web",
                                                                "rubro_grupo_contable" =>  "servicios",
                                                                "detalle"           => array (
                                                                                        0   => array (
                                                                                                "cantidad"  => "1",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "PAPAS",
                                                                                                                        "unidad_bulto"  => "10",
                                                                                                                        "lista_precios" =>  "MI LISTA DE PRECIOS",
                                                                                                                        "codigo"        =>  "",
                                                                                                                        "precio_unitario_sin_iva" => "100.45" ,
                                                                                                                        "alicuota"              =>   "21"
                                                                                                                        "unidad_medida" => "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  "blanca, cepillada"
                                                                                                    ), // end detalle item


                                                                                        1   => array (
                                                                                                "cantidad"  => "1.5",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "HUEVOS",
                                                                                                                        "unidad_bulto"  => "30",
                                                                                                                        "lista_precios" =>  "MAPPLETS",
                                                                                                                        "codigo"        =>  "MPH",
                                                                                                                        "precio_unitario_sin_iva"=> "50" ,
                                                                                                                        "alicuota"              =>   "21" 
                                                                                                                        "unidad_medida" => "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  ""
                                                                                                    ), // end detalle item

                                                                                        2   => array (
                                                                                                "cantidad"  => "2",
                                                                                                "producto"  => array (
                                                                                                                        "descripcion"   => "ZANAHORIA",
                                                                                                                        "unidad_bulto"  => "50",
                                                                                                                        "lista_precios" =>  "MI LISTA DE PRECIOS",
                                                                                                                        "codigo"        =>  "ZNH1",
                                                                                                                        "precio_unitario_sin_iva"=> "200" ,
                                                                                                                        "alicuota"              =>   "21",  
                                                                                                                        "unidad_medida" => "7"
                                                                                                                    ), //end producto
                                                                                                "leyenda"   =>  ""
                                                                                                    ), // end detalle item
                                                                                    ) , // end detalle
                                                            "bonificacion"              =>   "120",

                                                            "leyenda_gral"              =>  "bla bla bla",
                                                            "percepciones_iibb"         =>   "20",
                                                            "percepciones_iva"          =>   "0",
                                                            "exentos"                   =>   "10",
                                                            "nogravados"                =>   "100",
                                                            "impuestos_internos"        =>   "0",
                                                            "total"                     =>   "681.09",

                                                            ), //end comprobante

                                    );



                        // EJECUTO VIA CURL EL REQUEST PARA GENERAR EL COMPROBANTE

                            $url="https://www.tusfacturas.com.ar/app/api/v2/facturacion/nuevo" ;
                            $ch = curl_init( $url );
                            curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode($facturacion_json) );
                            curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
                            curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
                            $rta        = json_decode(curl_exec($ch));
                            curl_close($ch);


                        // MANEJO LA RESPUESTA
                            if ($rta->error == "N") {
                                echo '  CAE otorgado:'.$rta->cae.'

                                        Vto:'.$rta->vencimiento_cae.'

                                        Vto pago: '.$rta->vencimiento_pago.'

                                        PDF del comprobante: '.$rta->comprobante_pdf_url ;
                            }else{
                                echo 'Se han encontrado los siguientes errores:'.implode(',',$rta->errores );

                            }

                      
                    


Ejemplo de Petición CURL para consultar un comprobante A

                      


                    $facturacion_json= array(
                                    /** Datos de la empresa que solicita el comprobante **/
                                    "usertoken"         =>  "jajajja8c8bf67c884e1405e26c03c85",
                                    "apikey"            =>  "9991",
                                    "apitoken"          =>  "kkakak208a17cdfc4e4741437baddaa6",

                                    "comprobante"       => array (
                                                            "operacion"         => "V",
                                                            "tipo"              => "FACTURA A",
                                                            "punto_venta"       => "2",
                                                            "numero"            => "61"
                                                            ),
                                    );



                        // EJECUTO VIA CURL EL REQUEST PARA GENERAR EL COMPROBANTE

                            $url="https://www.tusfacturas.com.ar/app/api/v2/facturacion/consulta" ;
                            $ch = curl_init( $url );
                            curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode($facturacion_json) );
                            curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
                            curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
                            $rta        = json_decode(curl_exec($ch));
                            curl_close($ch);


                        // MANEJO LA RESPUESTA
                            if ($rta->error == "N") {
                                echo '  CAE otorgado:'.$rta->comprobante->cae.'
                                        Vto:'.$rta->comprobante->vencimiento_cae.'
                                        Vto pago: '.$rta->comprobante->vencimiento_pago.'
                                        PDF del comprobante: '.$rta->comprobante->comprobante_pdf_url ;


                            }else{

                                echo 'Se han encontrado los siguientes errores:'.implode(',',$rta->errores );

                            }

                      
                    


Ejemplo de Petición CURL para consultar la próxima numeración de un comprobante A

                      


                    $facturacion_json= array(
                                    /** Datos de la empresa que solicita el comprobante **/
                                    "usertoken"         =>  "jajajja8c8bf67c884e1405e26c03c85",
                                    "apikey"            =>  "9991",
                                    "apitoken"          =>  "kkakak208a17cdfc4e4741437baddaa6",

                                    "comprobante"       => array (
                                                            "operacion"         => "V",
                                                            "tipo"              => "FACTURA A",
                                                            "punto_venta"       => "2"
                                                            ),
                                    );



                        // EJECUTO VIA CURL EL REQUEST PARA GENERAR EL COMPROBANTE

                            $url="https://www.tusfacturas.com.ar/app/api/v2/facturacion/numeracion" ;
                            $ch = curl_init( $url );
                            curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode($facturacion_json) );
                            curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
                            curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
                            $rta        = json_decode(curl_exec($ch));
                            curl_close($ch);


                        // MANEJO LA RESPUESTA
                            if ($rta->error == "N") {
                                echo '  Punto de venta:'.$rta->comprobante->punto_venta.'
                                        Número:'.$rta->comprobante->numero.'
                                        Tipo: '.$rta->comprobante->tipo ;


                            }else{

                                echo 'Se han encontrado los siguientes errores:'.implode(',',$rta->errores );

                            }

                      
                    




Ejemplo de Petición CURL para consultar existencia en padron arba

                      


                    $facturacion_json= array(
                                    /** Datos de la empresa que solicita el comprobante **/
                                    "usertoken"         =>  "jajajja8c8bf67c884e1405e26c03c85",
                                    "apikey"            =>  "9991",
                                    "apitoken"          =>  "kkakak208a17cdfc4e4741437baddaa6",

                                    "cliente"       => array (
                                                            "documento_nro"         => "30712293841",
                                                            "documento_tipo"        => "CUIT"
                                                            ),
                                    );



                        // EJECUTO VIA CURL EL REQUEST PARA GENERAR EL COMPROBANTE

                            $url="https://www.tusfacturas.com.ar/app/api/v2/clientes/arba-padron" ;
                            $ch = curl_init( $url );
                            curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode($facturacion_json) );
                            curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
                            curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
                            $rta        = json_decode(curl_exec($ch));
                            curl_close($ch);


                        // MANEJO LA RESPUESTA
                            if ($rta->error == "N") {
                                echo '  Alicuota de percepcion:'.$rta->alicuota_percepcion.'
Alicuota de retencion:'.$rta->alicuota_retencion ; }else{ echo 'Se han encontrado los siguientes errores:'.implode(',',$rta->errores ); }


Tablas de referencia

Provincias

Provincia     Valor a enviar
-   26
BUENOS AIRES   2
CATAMARCA   3
CHACO   4
CHUBUT   5
CIUDAD AUTONOMA DE BUENOS AIRES   1
CORDOBA   6
CORRIENTES   7
ENTRE RIOS   8
FORMOSA   9
JUJUY   10
LA PAMPA   11
LA RIOJA   12
MENDOZA   13
MISIONES   14
NEUQUEN   15
Otro   25
RIO NEGRO   16
SALTA   17
SAN JUAN   18
SAN LUIS   19
SANTA CRUZ   20
SANTA FE   21
SANTIAGO DEL ESTERO   22
TIERRA DEL FUEGO   23
TUCUMAN   24

Condiciones de venta

Condición de Venta     Valor a enviar
10 dias   10
15 dias   15
20 dias   20
30 dias   30
45 dias   45
60 dias   60
90 dias   90
Contado   0
Cuenta corriente   9999
Transferencia Bancaria   1

Condiciones ante el IVA

Condición ante el IVA     Valor a enviar
Consumidor Final     CF
Responsable Inscripto     RI
Monotributo     M
Exento     E

Tipos de comprobantes

FACTURA A
FACTURA B
NOTA DE DEBITO A
NOTA DE DEBITO B
NOTA DE CREDITO A
NOTA DE CREDITO B
FACTURA NO VALIDA EN AFIP
NOTA DE CREDITO NO VALIDA EN AFIP
FACTURA C
NOTA DE DEBITO C
NOTA DE CREDITO C
FACTURA M
NOTA DE DEBITO M
NOTA DE CREDITO M
REMITO
FACTURA E
NOTA DE DEBITO E
NOTA DE CREDITO E
PRESUPUESTO

Monedas

Moneda     Valor a enviar
Pesos Argentinos     PES
Dolares estadounidenses     DOL

Idiomas

Idioma     Valor a enviar
Español     1
Ingles     2

Productos - Unidades de Medida AFIP

También puede consultar ésta información con el método Consultar unidades de medida AFIP

Unidad de medida     Valor a enviar
1000 kWh   6
anulación/devolución   95
centímetros   20
cm cúbicos   27
curie   48
dam cúbicos   30
docenas   9
gramo activo   67
gramo base   68
gramos   14
gruesa   54
hectolitros   18
hm cúbicos   31
jgo. pqt. mazo naipes   25
kg activo   66
kg base   53
kg bruto   61
kilogramos   1
kilómetros   17
km cúbicos   32
litros   5
metros   2
metros cuadrados   3
metros cúbicos   4
microcurie   50
microgramos   33
milicurie   49
miligramos   41
mililitros   47
milimetros   15
millares   11
mm cúbicos   16
muiactant   63
muiacthor   52
muiactig   65
nanogramos   34
otras unidades   98
packs   96
pares   8
picogramos   35
quilates   10
seña/anticipo   97
toneladas   29
uiactant   62
uiacthor   51
uiactig   64
unidades   7

¿Estás listo para comenzar a facturar electrónicamente?

Nosotros te ayudamos :)

EMPEZAR A PROBAR AHORA

Contacto

Envianos tu consulta, o comentarios.

Recibimos correctamente tu mensaje. Én breve nos contactaremos
Ooops! Se produjo un error al enviar el mensaje. Por favor intente nuevamente.