Facura 24/7 - API

Documentación

Métodos de la API

Información necesaria para integrar tu sistema.

Respuestas de la API

Se devuelve la información en formato JSON y ZIP.

Ayuda especializada

Ayudamos a integrar tu sistema con nuestra API

Método - Comprobantes

Obtiene los comprobantes emitidos o recibidos directamente del servidor del SAT relacionados con el RFC especificado como parámetro en un periodo de tiempo determinado.

Parámetros:

  1. rfc: Cadena de texto con el Registro Federal de Contribuyentes (RFC) del cual se desea obtener los comprobantes.
  2. password: Cadena de texto con la Contraseña del portal de factura electrónica del SAT asociada al RFC.
  3. inicio: Fecha (en formato YYYYMMDD) a partir de la cual se realizará la búsqueda de los comprobantes. Si la fecha se envía en formato YYYYMM, entonces el sistema realizará la búsqueda iniciando el primer día del mes indicado.
  4. fin: Fecha (en formato YYYYMMDD) en que termina el periodo dentro del cual se desea realizar la búsqueda de los comprobantes. Si la fecha se envía en formato YYYYMM, entonces el sistema realizará la búsqueda terminando el último día del mes indicado.
  5. emitido: Valor Booleano (true o false) que indica que tipo de comprobantes se desean recuperar. Si el parámetro se envía como true, entonces buscará los comprobantes emitidos, si se manda cómo false, entonces buscará los comprobantes recibidos.
  6. apikey: Cadena de texto que fue entregada al cliente al momento de contratar el servicio. Para realizar pruebas puede usar el apikey “demo” la cual solo obtendrá los primeros 5 comprobantes que coincidan con los parámetros de búsqueda.

Ejemplo

$.ajax({"url":'https://factura24-7.com/api/index.php/sat_rest/comprobantes/', "type":"POST", "data":
{apikey: $("#apikey").val(), rfc: $("#rfc").val(),
password: $("#password").val(), inicio: finicio, fin: ffin, emitido: $('input:radio[name=emitido]:checked').val() }})
.done(function( data ) {
$("#resultado").html("Resultado: " + JSON.stringify(data));
//alert(data.zip);
$("#zip").attr("href", data.zip);
if(data["zip"] != undefined){
$("#zip").attr("style", "display:block;");
$("#zip").html("Download");
}
 }).error(function(data){
$("#resultado").html(JSON.stringify(data));
 });

Respuestas

Comprobantes encontrados: Devuelve información en formato JSON que incluye:

Code: Código de estatus de la operación.
Json: Objeto que contiene los siguientes atributos:

1.- result: Cantidad de comprobantes encontrados.
2.- data: Vector que almacena objetos de tipo json.
3.- Zip: Ruta del archivo zip que incluye todos los comprobantes obtenidos mediante la búsqueda. Este archivo se borrará al hacer una nueva consulta de ese RFC o después de un tiempo al azar. Es importante descargarlo inmediatamente.

data (Atributos)
folio_fiscal: Folio fiscal del comprobante.
rfc_emisor: Registro Federal de Contribuyentes de quien emitió el comprobante.
razon_social_emisor: Nombre de la persona física o moral al que pertenece el rfc_emisor.
rfc_receptor: Registro Federal de Contribuyentes de quien recibió el comprobante.
razon_social_receptor: Nombre de la persona física o moral al que pertenece el rfc_ receptor.
fecha_de_emision: Fecha en que se emitió el comprobante.
fecha_de_certificacion: Fehca de certificación del comprobante.
pac_que_certifico: Clave del PAC autorizado por el SAT que certificó el comprobante.
total: Monto total marcado en el comprobante.
efecto_del_comprobante: Especifica si el comprobante debe considerarse como un ingreso o un egreso por parte del emisor.
estado_del_comprobante: Identifica si el comprobante no ha sido cancelado.
fecha_de_cancelacion: Fecha en la que se hiso la cancelación del comprobante, si es que esta ha sucedido.
tipo: Indica si el coprobante fue recibido o emitido por el rfc mediante el cual se realizó la búsqueda.
xml_url: ruta donde se puede descargar el archivo directamente del servidor del SAT, siempre y cuando se encuentre con sesión activa el usuario con rfc correspondiente.

Sin comprobantes encontrados: Devuelve la siguiente cadena en formato JSON

{"code":0,"json":"\"{'mensaje': 'No se encontraron resultados'}\""}

Mensajes de error

Parámetro rfc no definido = Se envía cuando el parámetro rfc no es enviado o es enviado vacío.
Parámetro password no definido = Sucede cuando el parámetro rfc no es enviado o es enviado vacío.
Parámetro inicio no definido = Sucede cuando el parámetro inicio no es enviado o es enviado vacío.
Parámetro fin no definido = Sucede cuando el parámetro fin no es enviado o es enviado vacío.
El parametro "emitido" solo puede tener de valor "true" o "false" = Sucede cuando el parámetro emitido tiene un valor incorrecto.

Mensajes de error

RFC no valido = Se envía cuando el parámetro rfc es enviado con un formato incorrecto.
APIKEY no válida = Sucede cuando el parámetro apikey no es enviado.
APIKEY no encontrado = Sucede cuando el parámetro apikey no está registrado dentro del sistema.
APIKEY sin comprobantes disponibles = Sucede cuando el parámetro apikey si se encuentra registrado, pero ya no cuenta con saldo para descargar comprobantes.
Datos de conexión al SAT incorrectos = Sucede cuando alguno de los parámetros rfc y/o password no contienen datos de conexión válidos para ingresar al portal del SAT.

Factura 24 / 7

Herramientas de gestión para la contabilidad. Mejora tus procesos y entrega mejores resultados.

Descarga masiva del SAT

Descarga masiva de todas las facturas del SAT de manera sencilla, desde cualquier dispositivo.

Integra nuestra API

Integra tu sistema contable o ERP con la descarga masiva utlizando nuestra sencilla API.