Mi Cuenta

Consulta de 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
Body Parameters
apikey
required
string
Tus credenciales de acceso
apitoken
required
string
Tus credenciales de acceso
usertoken
required
string
Tus Credenciales de acceso
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
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
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": "tumail@dominio.com"
}

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
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.
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

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": "tuemail@tudominio.com",
"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": "info@tudominio.com.ar",
"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
Body Parameters
apitoken
required
string
Tus credenciales de acceso
apikey
required
string
Tus credenciales de acceso
usertoken
required
string
Tus credenciales de acceso
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
Body Parameters
apikey
required
string
Tus credenciales de acceso
apitoken
required
string
Tus credenciales de acceso
usertoken
required
string
Tus credenciales de acceso.
200: OK

Ejemplo del JSON a enviar:

JSON
{
"usertoken":"JHJKHJHJKHJK",
"apitoken":"HJKHJHJKHKJHK",
"apikey":"111"
}