Preguntas frecuentes sobre la API de facturas

Usa el getInvoicesAttributes operación para obtener los valores válidos para cada mercado admitido.

No. Puedes llamar al getInvoicesExport operación cada pocos minutos hasta que el estado sea DONE o un ERROR se devuelve.

El getInvoicesDocument la respuesta incluye el invoicesDocumentUrl atributo, que proporciona una URL que puede usar para descargar un archivo ZIP. El archivo ZIP contiene los archivos de factura en formato XML. Tenga en cuenta que la URL caduca en 30 segundos (según lo indicado por X-Amz-Expires).

El nombre de cada archivo de factura XML es el mismo que el valor del atributo ID del getInvoices respuesta.

No. Solo puedes filtrar por una factura a la vez mediante el invoiceExternalId atributo. Sin embargo, puede filtrar por período y relacionar los archivos con las facturas. Consulte el pregunta anterior.

El valor predeterminado es de 0,1 solicitudes por segundo con un tamaño máximo de 200 elementos por página (pageSize = 200). Sin embargo, la cantidad de solicitudes por intervalo puede variar según el proveedor. Para obtener el límite de solicitudes y evitar problemas de limitación (error 429), consulte x-amzn-RateLimit-Limit valor.

1. Panel de informes: Un integrador proporciona un panel de informes donde los vendedores pueden visualizar y extraer todas las facturas.
2. Panel de pedidos: Los vendedores pueden acceder y extraer sus facturas de venta a través del panel de pedidos del integrador.
3. Integración de API (ERP): Un integrador proporciona todas las facturas a través de sus propias API, lo que permite a los vendedores integrar los datos de sus facturas directamente en su propio ERP o sistema de contabilidad.

Antes de importar el archivo de factura, puede obtener los metadatos de la factura mediante el getInvoices operación. En la respuesta, el identificador del pedido está disponible en transactionId atributo para todas las facturas relacionadas con ese pedido.

getInvoices puede devolver un máximo de 50 000 resultados (con hasta 200 elementos por página). Si la consulta arroja un número superior a 50 000, 400 se devuelve un error (solicitud incorrecta) con este mensaje de error:

"errors": [ 
    { 
        "code": "InvalidInput", 
        "message": "There are too many invoices in a single list request. Please, change your filter expression to reduce the number of invoices from 138217 to be lower than 50000.", 
        "details": "" 
    }
]

Para evitar este error, puede implementar una rutina diaria para buscar las facturas mediante un filtro de fechas (de D-2 a D-0) y devolver un máximo de 200 artículos por página (pageSize = 200). Como las facturas pueden cambiar en las primeras 24 horas y puede producirse un retraso en la emisión de las facturas (por ejemplo, la inestabilidad de Sefaz), es mejor utilizar las facturas emitidas hace más de 24 horas (D-2).

Amazon tiene 24 horas para cancelar la factura de un vendedor y reflejar esta nueva CANCELLED estado. Transcurrido este período de 24 horas, el vendedor puede cancelar la factura directamente con Sefaz (dentro de un período que varía según el estado, normalmente hasta siete días a partir de la autorización).

📘

Nota

Si cancela una factura con Sefaz, el CANCELLED el estado no se refleja en los resultados de la API de facturas. Esto se debe a que Amazon no recibe ninguna notificación de este tipo de cancelación. Para validar una factura cancelada a través de Sefaz, debes ponerte en contacto con Sefaz.