Invoices - Download Documents By Billing Account
Ottiene un URL per scaricare più documenti di fattura (pdf fattura, ricevute fiscali, note di credito) come file ZIP. L'operazione è supportata per gli account di fatturazione con tipo di contratto Microsoft Partner Agreement o Contratto del cliente Microsoft.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/downloadDocuments?api-version=2024-04-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
billing
|
path | True |
string |
ID che identifica in modo univoco un account di fatturazione. Criterio di espressione regolare: |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
parameters |
Elenco dei dettagli di download per i singoli documenti. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
URL sicuro che può essere usato per scaricare un'entità fino alla scadenza dell'URL. |
|
202 Accepted |
Risultato accettato dell'operazione che restituisce un'intestazione 'Location' di cui il client può eseguire il polling per visualizzare il risultato dell'operazione. Intestazioni
|
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Esempio
InvoicesDownloadDocumentsByBillingAccount
Esempio di richiesta
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/downloadDocuments?api-version=2024-04-01
[
{
"documentName": "12345678",
"invoiceName": "G123456789"
},
{
"documentName": "12345678",
"invoiceName": "G987654321"
}
]
Risposta di esempio
{
"expiryTime": "2023-02-16T17:32:28Z",
"url": "https://myaccount.blob.core.windows.net/invoices/1383724.pdf?sv=2019-02-02&sr=b&sp=r"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/operationResults/invoiceDownload_11111111-1111-1111-1111-111111111111?api-version=2024-04-01
Retry-After: 10
Definizioni
Nome | Descrizione |
---|---|
Document |
Elenco dei dettagli di download per i singoli documenti. |
Document |
URL sicuro che può essere usato per scaricare un'entità fino alla scadenza dell'URL. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
DocumentDownloadRequest
Elenco dei dettagli di download per i singoli documenti.
Nome | Tipo | Descrizione |
---|---|---|
documentName |
string |
ID che identifica in modo univoco un documento di fattura. Questo ID può essere un identificatore per un PDF della fattura, una nota di credito o una ricevuta fiscale. Se omesso, verrà restituito il PDF della fattura più recente per la fattura. |
invoiceName |
string |
ID che identifica in modo univoco una fattura. |
DocumentDownloadResult
URL sicuro che può essere usato per scaricare un'entità fino alla scadenza dell'URL.
Nome | Tipo | Descrizione |
---|---|---|
expiryTime |
string |
Ora in formato UTC alla scadenza dell'URL di download. |
url |
string |
URL del file PDF o .zip. |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |