Descarga de Facturas Emitidas
Endpoint: GET /cfdi/emitted/
¿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"
}
Updated about 2 years ago