API TusFacturas.app - Mi Cuenta

Consulta desde la API de TusFacturas.app, la información relacionada con tu cuenta

post
Consultá el consumo de tu cuenta
https://www.tusfacturas.app/app/api/v2/micuenta/consumo
Éste método te brindara que cantidad de comprobantes podes emitir en el mes en curso, cuantos tenés programados como abono, y cuantos te quedan disponibles.
Request
Response
Request
Body Parameters
apikey
required
string
Tus credenciales de acceso
apitoken
required
string
Tus credenciales de acceso
usertoken
required
string
Tus Credenciales de acceso
Response
200: OK
JSON
{
"error":"N",
"errores":[],
"abonos_pendientes":21,
"comprobantes_generados":12,
"comprobantes_cupo":100,
"comprobantes_disponibles": 79
}
Ejemplo del JSON a enviar:
JSON
{
   "usertoken":"JHJKHJHJKHJK",
    "apitoken":"HJKHJHJKHKJHK",
    "apikey":"111" 
}
​
post
Solicitá el IVA Compras - Ventas
https://www.tusfacturas.app/app/api/v2/micuenta/iva_compras_ventas
Mediante éste método, solicitarás el envío del reporte IVA compras-ventas a una casilla de e-mail determinada. Se permite 1 casilla solamente por solicitud.
Request
Response
Request
Body Parameters
anio
required
number
El año del período que se consulta.
mes
required
number
El mes del período que se consulta.
email
required
string
La dirección de e-mail a donde se enviará el reporte
apikey
required
string
Tus credenciales de acceso
apitoken
required
string
Tus credenciales de acceso
usertoken
required
string
Tus credenciales de acceso

Response
200: OK
La respuesta es error = S o error = N
JSON
{
"error":"N",
"errores":[]
}
Ejemplo del JSON a enviar:
JSON
{
"usertoken" :  "5ef7asdasdadsaa1b88fcabba3f",
"apikey"    :  "13562",
"apitoken"  :  "7668aadas21321adasdiaddaa6",
"mes": 11,
"anio": 2018,
"email": "[email protected]"
​
}
​
post
Administrar CUIT + Punto de venta
https://www.tusfacturas.app/app/api/v2/puntos_venta/administrar
Mediante éste método podrás crear nuevos puntos de venta o modificar el punto de venta enviado y recibir el instructivo para el enlace con AFIP (según corresponda).

Comentarios para modificación de puntos de venta:
- En el caso de la modificación del punto de venta, deberás realizar la solicitud con las keys del punto de venta  que querés modificar.
- Ten en cuenta que aquellos puntos de venta que ya posean comprobantes, no podrán modificar su número de CUIT, condición impositiva ni de punto de venta.

Comentarios para el alta de puntos de venta:
- Si das de alta un punto de venta de un CUIT que ya existía y emitía factura electrónica, automáticamente éste quedará habilitado para emitir factura electrónica AFIP, sin requerir cargar en AFIP un nuevo certificado de seguridad. Lo único que deberás hacer en AFIP, es dar de alta el nuevo punto de venta de tipo "webservices".

Request
Response
Request
Body Parameters
operacion
required
string
Valores esperados: A  o M 
A = Alta de nuevo punto de venta 
M = Modifica el punto de venta, correspondiente a las apikey desde las cuales estoy enviando para hacer el request.
conceptos_tipo
required
string
Debe indicar el tipo de conceptos que factura, los cuales pueden ser:
P = Productos 
PS = Productos y Servicios
S = Servicios
es_predeterminado
required
string
Indica si el CUIT + Punto de venta es el predeterminado. Valores esperados: S o N
esta_activo
required
string
Indica si el CUIT + Punto de venta se encuentra activo y disponible para generar comprobantes. Valores esperados: S o N
mercadopago
optional
object
Según objeto "mercadopago" que se detalla abajo.
xero
optional
object
Según objeto "xero" que se detalla abajo.
es_agente_retencion
required
string
Indica si el punto de venta es agente de retención. Valores esperados: S o N.
factura
required
object
Un objeto del tipo "factura" según se detalla abajo.
punto_venta
required
number
El número del punto de venta a crear. 
Ej: 4
factura_afip
required
string
Indica si va a querer emitir factura electrónica AFIP.  En el caso que la respuesta sea "S", se enviará ademas, via email (a la casilla del administrador), el instructivo para realizar el enlace con AFIP, junto con el certificado de seguridad requerido por AFIP.
Valores esperados: S o N.

fecha_inicio
required
string
Fecha de inicio de actividades. Formato: dd/mm/aaaa
iibb
required
string
El nro de ingresos brutos.
iva_emails
optional
string
Las direcciones de email separadas por coma donde quieren recibir mensualmente el iva compras-ventas.
iva_condicion
required
string
La condición impositiva según tabla de referencia. 
direccion
required
string
El domicilio fiscal. Dirección + número
cuit
required
number
Tu CUIT. Solo números.
razon_social
required
string
La razón social
apitoken
required
string
Tus credenciales actuales de acceso.
apikey
required
string
Tus credenciales actuales de acceso.
usertoken
required
string
Tus credenciales actuales de acceso.
Response
200: OK
Retorna todos los datos asociados al punto de venta.

{
	"error": "N",
	"errores": [],
	"envio_instructivo": "N",
	"apikey": 123,
	"apitoken": "KSKJSJSHHAHHSGSGGSA",
	"usertoken": "SJDSHJADGHSAJDHSG"
}
​
En caso de detectar errores, se devolverá la variable error en "S" 
y dentro de errores, los diferentes mensajes enviados.P
Ej:
​
{
	"error": "S",
	"errores": ["Se han encontrado los siguientes errores:El cuit ingresado 2112321321 no es v\u00e1lido "],
	"apikey": "",
	"apitoken": "",
	"usertoken": "",
	"envio_instructivo": "N"
}
Objeto "mercadopago"
Campo a enviar
Descripción
api_key
La API KEY obtenida desde MercadoPago.
api_secret
La API SECRET obtenieda desde MercadoPago.
Objeto "xero"
Campo a enviar
Descripción
habilitado
Indica si se encuentra habilitado o no. Valores esperados: S o N
consumer_key
La consumer KEY obtenida desde XERO
shared_secret
La shared_secret obtenida desde XERO
habilitado_web
Indica si se encuentra habilitado para sincronizar con XERO cuando se emiten comprobantes desde la plataforma web. Valores esperados: S o N
habilitado_api
Indica si se encuentra habilitado para sincronizar con XERO cuando se emiten comprobantes desde la API. Valores esperados: S o N
Objeto "factura"
Campo a enviar
Descripcion
leyenda_general_predeterminada
Una leyenda predeterminada que saldrá impresa en todos los comprobantes que emitas.
titulo
El titulo que saldrá como encabezado de la factura. En gral se usa la razón social o el nombre de fantasía de la empresa. Máx de caracteres permitidos: 18
subtitulo
El subtitulo que saldrá en el encabezado de la factura, bajo el titulo principal. Máx de caracteres permitidos: 18
reply_to_email
La dirección de email para los reply-to en cada envío de comprobante.
reply_to
El nombre de quien envía los comprobantes.
mensaje
El mensaje predeterminado que saldrá en el envío de cada comprobante.
copias
La cantidad de copias que se generan dentro del PDF. Valores esperados:  2= para recibir original y duplicado, 3= para recibir original, duplicado y triplicado
cbu
Opcional: El número del CBU. Campo numérico, maximo 30 dígitos.
JSON De ejemplo a enviar
JSON
{
   "usertoken":"JHJKHJHJKHJK",
    "apitoken":"HJKHJHJKHKJHK",
    "apikey":"111",
    "operacion":"A",
    "punto_venta": "00023",
    "direccion":"AV. 68 N75A - 50, PISO 4, Buenos Aires, Argentina",
    "razon_social": "MI CUIT DE PRUEBA",
    "cuit": "11111123213",
    "iva_condicion": "M",
    "iva_emails": "[email protected]",
    "iibb":"12345",
    "fecha_inicio": "12/12/2017",
    "factura_afip": "S",
    "es_agente_retencion": "N",
    "esta_activo": "S",
    "es_predeterminado": "S",
    "conceptos_tipo": "PS",
    "factura" : {
        "leyenda_general_predeterminada": "TEST",
        "titulo" : "PIRULO & CO",
        "subtitulo": "La mejor barberia",
        "reply_to_email": "[email protected]",
        "reply_to": "PIRULO",
        "mensaje": "Le enviamos la factura que se encuentra adjunta",
        "copias": "2"
    }
​
}
​
​
post
Predeterminar CUIT + Punto de venta
https://www.tusfacturas.app/app/api/v2/puntos_venta/predeterminar
Marca como predeterminado el punto de venta desde el cual estoy realizando la solicitud.
Request
Response
Request
Body Parameters
apitoken
required
string
Tus credenciales de acceso
apikey
required
string
Tus credenciales de acceso
usertoken
required
string
Tus credenciales de acceso

Response
200: OK
{
	"error": "N",
	"errores": [] 
}
Ejemplo del JSON a enviar:
JSON
{
   "usertoken":"JHJKHJHJKHJK",
    "apitoken":"HJKHJHJKHKJHK",
    "apikey":"111" 
}
​
post
Solicitar certificado
https://www.tusfacturas.app/app/api/v2/puntos_venta/certificado
Mediante éste método podrás obtener en la casilla de e-mail de los administradores de tu cuenta, un nuevo certificado de seguridad.
El certificado se generará para el  CUIT desde el cual estas haciendo la solicitud.
Request
Response
Request
Body Parameters
apikey
required
string
Tus credenciales de acceso
apitoken
required
string
Tus credenciales de acceso
usertoken
required
string
Tus credenciales de acceso.
Response
200: OK
​
Ejemplo del JSON a enviar:
JSON
{
   "usertoken":"JHJKHJHJKHJK",
    "apitoken":"HJKHJHJKHKJHK",
    "apikey":"111" 
}
​
​
​
​

API Factura electrónica AFIP - Consulta de alícuotas en padrón AGIP.

API TusFacturas.app - Clientes: Cuenta Corriente

Last updated 1 year ago

Campo a enviar	Descripción
api_key	La API KEY obtenida desde MercadoPago.
api_secret	La API SECRET obtenieda desde MercadoPago.

Campo a enviar	Descripción
habilitado	Indica si se encuentra habilitado o no. Valores esperados: S o N
consumer_key	La consumer KEY obtenida desde XERO
shared_secret	La shared_secret obtenida desde XERO
habilitado_web	Indica si se encuentra habilitado para sincronizar con XERO cuando se emiten comprobantes desde la plataforma web. Valores esperados: S o N
habilitado_api	Indica si se encuentra habilitado para sincronizar con XERO cuando se emiten comprobantes desde la API. Valores esperados: S o N

Campo a enviar	Descripcion
leyenda_general_predeterminada	Una leyenda predeterminada que saldrá impresa en todos los comprobantes que emitas.
titulo	El titulo que saldrá como encabezado de la factura. En gral se usa la razón social o el nombre de fantasía de la empresa. Máx de caracteres permitidos: 18
subtitulo	El subtitulo que saldrá en el encabezado de la factura, bajo el titulo principal. Máx de caracteres permitidos: 18
reply_to_email	La dirección de email para los reply-to en cada envío de comprobante.
reply_to	El nombre de quien envía los comprobantes.
mensaje	El mensaje predeterminado que saldrá en el envío de cada comprobante.
copias	La cantidad de copias que se generan dentro del PDF. Valores esperados: 2= para recibir original y duplicado, 3= para recibir original, duplicado y triplicado
cbu	Opcional: El número del CBU. Campo numérico, maximo 30 dígitos.

API TusFacturas.app - Mi Cuenta

postConsultá el consumo de tu cuenta

Ejemplo del JSON a enviar:

postSolicitá el IVA Compras - Ventas

Ejemplo del JSON a enviar:

postAdministrar CUIT + Punto de venta

Objeto "mercadopago"

Objeto "xero"

Objeto "factura"

JSON De ejemplo a enviar

postPredeterminar CUIT + Punto de venta

Ejemplo del JSON a enviar:

postSolicitar certificado

Ejemplo del JSON a enviar:

post
Consultá el consumo de tu cuenta

post
Solicitá el IVA Compras - Ventas

post
Administrar CUIT + Punto de venta

post
Predeterminar CUIT + Punto de venta

post
Solicitar certificado