| description |
|---|
Consulta desde la API de TusFacturas.app, la información relacionada con tu cuenta. |
{% swagger baseUrl="https://www.tusfacturas.app/app/api" path="/v2/micuenta/consumo" method="post" summary="Consultá el consumo de tu cuenta" %} {% swagger-description %} É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. {% endswagger-description %}
{% swagger-parameter in="body" name="apikey" type="string" %} Tus credenciales de acceso {% endswagger-parameter %}
{% swagger-parameter in="body" name="apitoken" type="string" %} Tus credenciales de acceso {% endswagger-parameter %}
{% swagger-parameter in="body" name="usertoken" type="string" %} Tus Credenciales de acceso {% endswagger-parameter %}
{% swagger-response status="200" description="" %} {% code title="JSON" %}
{
"error":"N",
"errores":[],
"abonos_pendientes":21,
"comprobantes_generados":12,
"comprobantes_cupo":100,
"comprobantes_disponibles": 79
}
{% endcode %} {% endswagger-response %} {% endswagger %}
{% code title="JSON" %}
{
"usertoken":"JHJKHJHJKHJK",
"apitoken":"HJKHJHJKHKJHK",
"apikey":"111"
}
{% endcode %}
{% swagger baseUrl="https://www.tusfacturas.app/app/api" path="/v2/micuenta/iva_compras_ventas" method="post" summary="Solicitá el IVA Compras - Ventas" %} {% swagger-description %} 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. {% endswagger-description %}
{% swagger-parameter in="body" name="anio" type="number" %} El año del período que se consulta. {% endswagger-parameter %}
{% swagger-parameter in="body" name="mes" type="number" %} El mes del período que se consulta. {% endswagger-parameter %}
{% swagger-parameter in="body" name="email" type="string" %} La dirección de e-mail a donde se enviará el reporte {% endswagger-parameter %}
{% swagger-parameter in="body" name="apikey" type="string" %} Tus credenciales de acceso {% endswagger-parameter %}
{% swagger-parameter in="body" name="apitoken" type="string" %} Tus credenciales de acceso {% endswagger-parameter %}
{% swagger-parameter in="body" name="usertoken" type="string" %} Tus credenciales de acceso
\
{% endswagger-parameter %}
{% swagger-response status="200" description="La respuesta es error = S o error = N" %} {% code title="JSON" %}
{
"error":"N",
"errores":[]
}
{% endcode %} {% endswagger-response %} {% endswagger %}
{% code title="JSON" %}
{
"usertoken" : "5ef7asdasdadsaa1b88fcabba3f",
"apikey" : "13562",
"apitoken" : "7668aadas21321adasdiaddaa6",
"mes": 11,
"anio": 2018,
"email": "tumail@dominio.com"
}
{% endcode %}
{% swagger baseUrl="https://www.tusfacturas.app/app/api" path="/v2/puntos_venta/administrar" method="post" summary="Administrar CUIT + Punto de venta" %} {% swagger-description %} 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".
\
{% endswagger-description %}
{% swagger-parameter in="body" name="operacion" type="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. {% endswagger-parameter %}
{% swagger-parameter in="body" name="conceptos_tipo" type="string" %} Debe indicar el tipo de conceptos que factura, los cuales pueden ser:
\
P = Productos
\
PS = Productos y Servicios
\
S = Servicios {% endswagger-parameter %}
{% swagger-parameter in="body" name="es_predeterminado" type="string" %} Indica si el CUIT + Punto de venta es el predeterminado. Valores esperados: S o N {% endswagger-parameter %}
{% swagger-parameter in="body" name="esta_activo" type="string" %} Indica si el CUIT + Punto de venta se encuentra activo y disponible para generar comprobantes. Valores esperados: S o N {% endswagger-parameter %}
{% swagger-parameter in="body" name="mercadopago" type="object" %} Según objeto "mercadopago" que se detalla abajo. {% endswagger-parameter %}
{% swagger-parameter in="body" name="xero" type="object" %} Según objeto "xero" que se detalla abajo. {% endswagger-parameter %}
{% swagger-parameter in="body" name="es_agente_retencion" type="string" %} Indica si el punto de venta es agente de retención. Valores esperados: S o N. {% endswagger-parameter %}
{% swagger-parameter in="body" name="factura" type="object" %} Un objeto del tipo "factura" según se detalla abajo. {% endswagger-parameter %}
{% swagger-parameter in="body" name="punto_venta" type="number" %} El número del punto de venta a crear.
\
Ej: 4 {% endswagger-parameter %}
{% swagger-parameter in="body" name="factura_afip" type="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.
\
{% endswagger-parameter %}
{% swagger-parameter in="body" name="fecha_inicio" type="string" %} Fecha de inicio de actividades. Formato: dd/mm/aaaa {% endswagger-parameter %}
{% swagger-parameter in="body" name="iibb" type="string" %} El nro de ingresos brutos. {% endswagger-parameter %}
{% swagger-parameter in="body" name="iva_emails" type="string" %} Las direcciones de email separadas por coma donde quieren recibir mensualmente el iva compras-ventas. {% endswagger-parameter %}
{% swagger-parameter in="body" name="iva_condicion" type="string" %} La condición impositiva según tabla de referencia. {% endswagger-parameter %}
{% swagger-parameter in="body" name="direccion" type="string" %} El domicilio fiscal. Dirección + número {% endswagger-parameter %}
{% swagger-parameter in="body" name="cuit" type="number" %} Tu CUIT. Solo números. {% endswagger-parameter %}
{% swagger-parameter in="body" name="razon_social" type="string" %} La razón social {% endswagger-parameter %}
{% swagger-parameter in="body" name="apitoken" type="string" %} Tus credenciales actuales de acceso. {% endswagger-parameter %}
{% swagger-parameter in="body" name="apikey" type="string" %} Tus credenciales actuales de acceso. {% endswagger-parameter %}
{% swagger-parameter in="body" name="usertoken" type="string" %} Tus credenciales actuales de acceso. {% endswagger-parameter %}
{% swagger-response status="200" description="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"
}
{% endswagger-response %} {% endswagger %}
| 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. |
{% code title="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"
}
}
{% endcode %}
{% swagger baseUrl="https://www.tusfacturas.app/app/api" path="/v2/puntos_venta/predeterminar" method="post" summary="Predeterminar CUIT + Punto de venta" %} {% swagger-description %} Marca como predeterminado el punto de venta desde el cual estoy realizando la solicitud. {% endswagger-description %}
{% swagger-parameter in="body" name="apitoken" type="string" %} Tus credenciales de acceso {% endswagger-parameter %}
{% swagger-parameter in="body" name="apikey" type="string" %} Tus credenciales de acceso {% endswagger-parameter %}
{% swagger-parameter in="body" name="usertoken" type="string" %} Tus credenciales de acceso
\
{% endswagger-parameter %}
{% swagger-response status="200" description="" %}
{
"error": "N",
"errores": []
}
{% endswagger-response %} {% endswagger %}
{% code title="JSON" %}
{
"usertoken":"JHJKHJHJKHJK",
"apitoken":"HJKHJHJKHKJHK",
"apikey":"111"
}
{% endcode %}
{% swagger baseUrl="https://www.tusfacturas.app/app/api" path="/v2/puntos_venta/certificado" method="post" summary="Solicitar certificado" %} {% swagger-description %} 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. {% endswagger-description %}
{% swagger-parameter in="body" name="apikey" type="string" %} Tus credenciales de acceso {% endswagger-parameter %}
{% swagger-parameter in="body" name="apitoken" type="string" %} Tus credenciales de acceso {% endswagger-parameter %}
{% swagger-parameter in="body" name="usertoken" type="string" %} Tus credenciales de acceso. {% endswagger-parameter %}
{% swagger-response status="200" description="" %}
{% endswagger-response %} {% endswagger %}
{% code title="JSON" %}
{
"usertoken":"JHJKHJHJKHJK",
"apitoken":"HJKHJHJKHKJHK",
"apikey":"111"
}
{% endcode %}