Ask the provider again for a file that failed
For a file the provider serves (xml, cdr, and void_xml, void_cdr of a void) that failed: it goes back to pending and is fetched again from where the provider said it is, with the full retry schedule. Answers the file as pending; a file already on its way is answered as it is. Refused with file_not_refetchable (and its reason) for the PDF (it is rendered here: POST /v1/invoices/{id}/files/pdf/regenerate), for a file that is already stored, and for a failure that asking again cannot fix (source_missing, source_not_allowed, file_too_large). Follow GET /v1/invoices/{id}/files or the event invoice.files_stored.
POST
https://api.invox.page/v1/invoices/{id}/files/{kind}/refetchAuthorization
Path parameters
Header parameters
Returns
202
The file is queued to be fetched again (or is already on its way). Retry-After says when to look.
JSON
400
organization_required: This credential needs to say which organization it acts on · validation_failed: The request is not valid
JSON
401
unauthenticated: No credential was sent · invalid_credential: The credential is not valid
JSON
403
missing_scope: The credential lacks the permission this operation requires · organization_mismatch: The X-Organization header names another organization than the key's · organization_archived: The organization is archived
JSON
404
not_found: The resource does not exist in this organization · file_not_found: The invoice has no file of that kind
JSON
409
file_not_refetchable: This file cannot be asked again from the provider · file_not_ready: The file is not stored yet
JSON
429
rate_limited: Too many requests
JSON
500
internal_error: The service failed
JSON
503
service_unavailable: The service cannot answer right now
JSON