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"
}

Did this page help you?