Descarga de Facturas Emitidas

¿Para qué sirve?

Mediante esta consulta obtendrás todas las facturas emitidas por la empresa a la que iniciaste sesión previamente, en el período de tiempo que indiques.

Parámetros requeridos

PARÁMETROS	DESCRIPCIÓN
session_key	Clave de autenticación que deberá ser usada en todas las requests siguientes.
date_start	Fecha Inicial de Emisión, formato (DD/MM/AAAA).
date_end	Fecha Final de Emisión, formato (DD/MM/AAAA).
status	· cancelled -> cancelado · valid -> vigente · any -> cualquier estado
action	· bulk_download -> descarga masiva · metadata_download -> descarga de metadata · pdf_export -> exportar resultados a pdf · list -> lista las facturas encontradas

Parámetros opcionales


type	Tipo de comprobante. Opciones: · recepcion_pagos

Posibles respuestas

📘
Si el rango de fechas especificado es mayor a 12 meses, se generaran varias descargas, cada una abarcando un período máximo de 12 meses.

STATUS	DESCRIPCIÓN
status	· success -> la información ha sido accedida correctamente. · error -> la sesión o la key es inválida.

Ejemplos

Descarga de Facturas Emitidas

GET /cfdi/emitted/?session_key=4d16be85-554e-4d26-a74d-cd1a3c0f93b8 HTTP/1.1
Host: fiscal.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

date_start=01%2F05%2F2017&date_end=07%2F06%2F2018&status=cancelled&action=bulk_download

curl -X GET "https://fiscal.sandbox.prometeoapi.com/cfdi/emitted/?session_key=4d16be85-554e-4d26-a74d-cd1a3c0f93b8" -d "date_start=01%2F05%2F2017&date_end=07%2F06%2F2018&status=cancelled&action=bulk_download" -H "X-API-Key: <API KEY>"

import requests

requests.get('https://fiscal.sandbox.prometeoapi.com/cfdi/emitted/', params={
    'session_key': '4d16be85-554e-4d26-a74d-cd1a3c0f93b8',
}, data={
    'date_start': '01/05/2017',
    'date_end': '07/06/2018',
    'status': 'cancelled',
    'action': 'bulk_download',
}, headers={
    'X-API-Key': '<API KEY>'
})

var request = require('request');

request.get({
  "url": "https://fiscal.sandbox.prometeoapi.com/cfdi/emitted/",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "qs": {
    "session_key": "4d16be85-554e-4d26-a74d-cd1a3c0f93b8"
  },
  "form": {
    "date_start": "01/05/2017",
    "date_end": "07/06/2018",
    "status": "cancelled",
    "action": "bulk_download"
  }
});

Respuesta de descarga masiva o de metadata exitosa

{
    "emitted": [
        {
            "request_id": "50AD2BA1-27AE-4CC3-84FD-265E585A1F67"
        },
        {
            "request_id": "A6326A6B-68D0-4580-9FAD-A22F987FE43E"
        }
    ],
    "status": "success"
}

Respuesta de exportación de PDF exitosa

{
    "emitted": [
        {
            "pdf_url": "/pdf/655ea3b7d0ec5fa1914aca7809e72449.pdf"
        }
    ],
    "status": "success"
}

Respuesta de listado de facturas

{
    "emitted": [
        {
            "certification_date": "2018-08-29T20:50:04",
            "certification_pac": "FIN1203015JA",
            "effect": "Ingreso",
            "emitted_date": "2018-08-29T20:50:03",
            "emitter_reason": "John Doe",
            "emitter_rfc": "ABCD90408BJ2",
            "id": "DDAA8B0B-4FDC-43D7-A633-F307B898AB3C",
            "receiver_reason": "Jane Doe",
            "receiver_rfc": "ZXYW740519633",
            "status": "valid",
            "total_value": 174.36
        },
        {
            "certification_date": "2018-08-30T09:43:55",
            "certification_pac": "FIN1203015JA",
            "effect": "Ingreso",
            "emitted_date": "2018-08-30T09:43:55",
            "emitter_reason": "John Doe",
            "emitter_rfc": "ABCD90408BJ2",
            "id": "EB758D6A-07F5-4947-ACD5-98BF0B61654F",
            "receiver_reason": "Company Name",
            "receiver_rfc": "ASD030224ES6",
            "status": "valid",
            "total_value": 106.22
        },
        {
            "certification_date": "2018-06-12T05:34:19",
            "certification_pac": "FIN1203015JA",
            "effect": "Ingreso",
            "emitted_date": "2018-06-12T05:34:19",
            "emitter_reason": "John Doe",
            "emitter_rfc": "ABCD790408BJ2",
            "id": "FB8C12A1-DA2C-47B0-B2FF-F10A718DB673",
            "receiver_reason": "Company Name",
            "receiver_rfc": "ZXC050315240",
            "status": "cancelled",
            "total_value": 231.41
        }
    ],
    "status": "success"
}