Descarga de Facturas Recibidas

Endpoint: GET /cfdi/received/

¿Para qué sirve?

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

PARÁMETROS	DESCRIPCIÓN
session_key	Clave de autenticación que deberá ser usada en todas las requests siguientes.
year	Año de emisión.
month	Mes de emisión.
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

Parámetros	Descripción
type	type -> Tipo de comprobante. Opciones: - recepcion_pagos

Posibles respuestas

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

Ejemplos

Descarga individual de XML de Facturas Emitidas

GET /cfdi/received/?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>

year=2018&month=1&status=valid&action=pdf_export

curl -X GET "https://fiscal.sandbox.prometeoapi.com/cfdi/received/?session_key=4d16be85-554e-4d26-a74d-cd1a3c0f93b8" -d "year=2018&month=1&status=valid&action=pdf_export" -H "X-API-Key: <API KEY>"

import requests

requests.get('https://fiscal.sandbox.prometeoapi.com/cfdi/received/', params={
    'session_key': '4d16be85-554e-4d26-a74d-cd1a3c0f93b8',
}, data={
    'year': '2018',
    'month': '1',
    'status': 'valid',
    'action': 'pdf_export',
}, headers={
    'X-API-Key': '<API KEY>'
})

var request = require('request');

request.get({
  "url": "https://fiscal.sandbox.prometeoapi.com/cfdi/received/",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "qs": {
    "session_key": "4d16be85-554e-4d26-a74d-cd1a3c0f93b8"
  },
  "form": {
    "year": "2018",
    "month": "1",
    "status": "valid",
    "action": "pdf_export"
  }
});

Respuesta de descarga masiva o de metadata exitosa

{
    "received": {
        "request_id": "CAF80916-71AC-4CEA-BECF-F2AC3F394948"
    },
    "status": "success"
}

Respuesta de exportación de PDF exitosa

{
    "received": {
        "pdf_url": "/pdf/5e0039b00fe101d11114576c2acc2a1b.pdf"
    },
    "status": "success"
}

Updated about 2 years ago