Consulta simple de comprobantes

Utilizá la API de facturación electrónica de TusFacturas.app, para consultar los comprobantes emitidos desde la plataforma, ya sea por una búsqueda puntual o una búsqueda avanzada.

Mediante éste método, podrás consultar la información asociada a un determinado comprobante.

Es importante que descargues toda la información, junto con el pdf y lo almacenes en tu plataforma, ya que si tu cuenta o suscripción no se encuentran vigentes, no podrás obtenerlo.

Tipo de datos: JSON Charset: UTF-8

Consulta individual de comprobante

POST https://www.tusfacturas.app/app/api/v2/facturacion/consulta

Request Body

Name	Type	Description
comprobante	object	Un objeto según estructura que se detalla a continuación.
apikey	string	Tus credenciales de acceso.
apitoken	string	Tus Credenciales de acceso.
usertoken	string	Tus Credenciales de acceso.

Estructura a enviar dentro del bloque: "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

Ejemplo de JSON a enviar :

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

Los datos devueltos por éste método mantienen la misma estructura que los enviados para generar un comprobante.

Ejemplo del JSON de respuesta:

La información que obtenés se devuelve estructurada de la misma manera que la enviaste, con el agregado de ciertos campos que se detallan a continuación

{
   "error": "N",
   "errores": [""]
   "rta": "OK",
   "cliente": {
      "documento_tipo": "DNI",
      "documento_nro": "1292963535 ",
      "razon_social": "Pirulo",
      "email": "[e-mail]",
      "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": "Gomas de borrar",
               "precio_unitario": 100,
               "alicuota": 21,
               "bonificacion": 0,
               "impuestos_internos_alicuota": 0,
               "precio_total": 100
            },
            "bonificacion_porcentaje": 0,
            "leyenda": ""
         }
      ],
      "bonificacion": 10,
      "leyenda_gral": " ",
      "percepciones_iibb": 30,
      "percepciones_iva": 0,
      "tributos": [
         {
            "tipo": 7,
            "tipo_descripcion": "Percepcion de IIBB",
            "regimen": 5,
            "regimen_descripcion": "BUENOS AIRES",
            "base_imponible": 100,
            "alicuota": 10,
            "total": 10
         },
         {
            "tipo": 7,
            "tipo_descripcion": "Percepcion de IIBB",
            "regimen": 6,
            "regimen_descripcion": "CATAMARCA",
            "base_imponible": 100,
            "alicuota": 20,
            "total": 20
         }
      ],
      "exentos": 0,
      "nogravados": 0,
      "impuestos_internos": 0,
      "impuestos_internos_base": 0,
      "impuestos_internos_alicuota": 0,
      "total": 138.90,
      "cae": "65301278726386 ",
      "external_reference": "Lun141",
      "micrositios": {
         "cliente": "url-del-micrositio",
         "descarga":"url-del-micrositio"
      },
      "tags": [
            "etiqueta1",
            "etiqueta2"
            ],
      "ctacte_status": "PAGO PARCIAL",
      "status": "EMITIDO",
      "afip_codigo_barras" : "12121212121006000300000000000000201811052 ",
      "afip_qr": "https:\/\/www.afip.gob.ar\/fe\/qr\/?p=eyJ2ZXIiOjEsImZlY2hhIjoiMjadadasdasdaAyMS0wNi0wNSIsImN1aXQiOiIyNzI4NTA1MTQ2NiIsInB0b1Z0YSI6IjEwIiwidGlwb0NtcCI6MSwibnJvQ21wIjoiMDAwMDAwNzgiLCJpbXBvcnRlIjoiMDAwMDAwMDAwMzA4NS41MCIsIm1vbmVkYSI6IlBFUyIs ",
      "vencimiento_cae": "07\/08\/2015",
      "vencimiento_pago": "27\/08\/2015",
      "comprobante_pdf_url": "https://www.dominio.com/00000006.pdf",
   }
}

Campos devueltos que no forman parte del JSON que vos envias:

Nombre del campo	Info
cae	Campo alfanumérico, con un espacio adicional, devuelto por AFIP, a modo e código de autorización electrónica de la transacción realizada
afip_qr	Campo alfanumérico, conteniendo el texto necesario para formar el QR
ctacte_status	Campo alfanumérico, conteniendo el estado del pago de ese comprobante dentro de la cuenta corriente. Los valores posibles son: PAGADA, IMPAGA , PAGO PARCIAL
status	Campo alfanumérico, conteniendo el estado de emisión de ese comprobante . Lo valores les son: "EMITIDO", "APROBADO Y EN COLA. SE EMITE EL dd/mm/aaaa", "EN COLA, ESPERANDO APROBACION", "ENVIADO A PROCESAR - CON ERROR"
afip_codigo_barras	Campo alfanumérico, conteniendo el texto necesario para formar el código de barras de AFIP (legacy)
vencimiento_cae	Fecha enviada por AFIP al momento de autorizar el comprobante. Formato: dd/mm/aaaa
vencimiento_pago	Fecha que indica la fecha de vencimiento del pago. Éste dato enviado por el cliente, o auto-calculado en base a la condición de pago estipulada en el perfil del cliente. Formato: dd/mm/aaaa
comprobante_pdf_url	Campo alfanumérico que al pdf del comprobante.
micrositios	En este campo se te devolverá la URL del micrositio del cliente y la de url del micrositio de descarga, solo si tu cuenta tiene los micrositios habilitados. Para configurarlo, ingresá a nuestra plataforma web, menú > mi espacio de trabajo > mis micrositios