Condividi tramite


Billing Accounts - Add Payment Terms

Aggiunge le condizioni di pagamento a tutti i profili di fatturazione nell'account di fatturazione. Attualmente, le condizioni di pagamento possono essere aggiunte solo per gli account di fatturazione con tipo di contratto "Contratto del cliente Microsoft" e AccountType come "Enterprise". Questa azione richiede l'autorizzazione preliminare e solo i venditori di campi sono autorizzati ad aggiungere le condizioni di pagamento e non è un'azione self-service.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/addPaymentTerms?api-version=2024-04-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
billingAccountName
path True

string

ID che identifica in modo univoco un account di fatturazione.

Criterio di espressione regolare: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$

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

PaymentTerm[]

Proprietà del termine di pagamento.

Risposte

Nome Tipo Descrizione
200 OK

BillingAccount

Elenco degli account di fatturazione.

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

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

PaymentTermsAdd

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/addPaymentTerms?api-version=2024-04-01

[
  {
    "term": "net10",
    "startDate": "2023-01-05T22:39:34.2606750Z",
    "endDate": "2023-01-25T22:39:34.2606750Z"
  }
]

Risposta di esempio

location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/operationResults/addPaymentTerms_ed2975a8-8f77-43bb-a717-ace54326b14b?api-version=2024-04-01
retry-after: 10
operation-id: ed2975a8-8f77-43bb-a717-ace54326b14b
{
  "id": "/providers/Microsoft.Billing/billingAccounts/010000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
  "name": "00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
  "properties": {
    "accountStatus": "Active",
    "accountType": "Business",
    "accountSubType": "Enterprise",
    "agreementType": "MicrosoftCustomerAgreement",
    "displayName": "Premier Business Account",
    "hasReadAccess": true,
    "primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
  },
  "type": "Microsoft.Billing/billingAccounts",
  "systemData": {
    "createdAt": "2023-01-04T22:39:34.2606750Z",
    "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
  }
}

Definizioni

Nome Descrizione
AccountStatus

Stato corrente dell'account di fatturazione.

AccountSubType

Livello dell'account.

AccountType

Tipo di cliente.

AgreementType

Tipo di contratto.

BillingAccount

Un account di fatturazione.

BillingAccountProperties

Un account di fatturazione.

BillingAccountStatusReasonCode

Motivo dello stato dell'account di fatturazione specificato.

BillingRelationshipType

Identifica le relazioni di fatturazione rappresentate da un account di fatturazione. La relazione di fatturazione può essere tra Microsoft, il cliente e/o una terza parte.

createdByType

Tipo di identità che ha creato la risorsa.

EnrollmentDetails

Proprietà di una registrazione.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ExtendedTermOption

L'estensione dell'account di fatturazione è stata scelta dall'azienda.

IndirectRelationshipInfo

Identifica il profilo di fatturazione collegato a un altro profilo di fatturazione nel movimento di acquisto indiretto.

MarkupStatus

Stato di markup della registrazione, applicabile solo per le registrazioni indirette.

PaymentTerm

Proprietà del termine di pagamento.

ProvisioningState

Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.

RegistrationNumber

Descrive il numero di registrazione dell'organizzazione collegata all'account di fatturazione.

SoldTo

Indirizzo dell'utente o dell'organizzazione responsabile dell'account di fatturazione.

SupportLevel

Offerta a livello di supporto associata a una registrazione.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

TaxIdentifier

Identificatore fiscale per l'account di fatturazione.

TaxIdentifierStatus

Stato dell'identificatore fiscale.

TaxIdentifierType

Tipo dell'identificatore fiscale.

AccountStatus

Stato corrente dell'account di fatturazione.

Nome Tipo Descrizione
Active

string

Deleted

string

Disabled

string

Expired

string

Extended

string

New

string

Other

string

Pending

string

Terminated

string

Transferred

string

UnderReview

string

AccountSubType

Livello dell'account.

Nome Tipo Descrizione
Enterprise

string

Individual

string

None

string

Other

string

Professional

string

AccountType

Tipo di cliente.

Nome Tipo Descrizione
Business

string

ClassicPartner

string

Enterprise

string

Individual

string

Internal

string

Other

string

Partner

string

Reseller

string

Tenant

string

AgreementType

Tipo di contratto.

Nome Tipo Descrizione
EnterpriseAgreement

string

MicrosoftCustomerAgreement

string

MicrosoftOnlineServicesProgram

string

MicrosoftPartnerAgreement

string

Other

string

BillingAccount

Un account di fatturazione.

Nome Tipo Descrizione
id

string

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nome della risorsa

properties

BillingAccountProperties

Un account di fatturazione.

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.

tags

object

Dizionario dei metadati associati alla risorsa. Potrebbe non essere popolato per tutti i tipi di risorse. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non deve essere vuoto né null. Le chiavi non possono contenere <> % & \ ? /

type

string

Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

BillingAccountProperties

Un account di fatturazione.

Nome Tipo Descrizione
accountStatus

AccountStatus

Stato corrente dell'account di fatturazione.

accountStatusReasonCode

BillingAccountStatusReasonCode

Motivo dello stato dell'account di fatturazione specificato.

accountSubType

AccountSubType

Livello dell'account.

accountType

AccountType

Tipo di cliente.

agreementType

AgreementType

Tipo di contratto.

billingRelationshipTypes

BillingRelationshipType[]

Identifica le relazioni di fatturazione rappresentate da un account di fatturazione. La relazione di fatturazione può essere tra Microsoft, il cliente e/o una terza parte.

displayName

string

Nome dell'account di fatturazione.

enrollmentDetails

EnrollmentDetails

Proprietà di una registrazione.

hasNoBillingProfiles

boolean

Indica se l'account di fatturazione ha o meno profili di fatturazione.

hasReadAccess

boolean

Indica se l'utente ha accesso in lettura all'account di fatturazione.

notificationEmailAddress

string

Indirizzo di posta elettronica di notifica per l'account legacy. Disponibile per il tipo di contratto Microsoft Online Services Program.

primaryBillingTenantId

string

Tenant usato per configurare l'account di fatturazione. Per impostazione predefinita, solo gli utenti di questo tenant possono ottenere assegnazioni di ruolo nell'account di fatturazione e viene effettuato il provisioning di tutti gli acquisti in questo tenant.

provisioningState

ProvisioningState

Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.

qualifications

string[]

Qualifiche per i prezzi per un account di fatturazione. I valori possono essere Commercial, Education, Charity o Government.

registrationNumber

RegistrationNumber

Descrive il numero di registrazione dell'organizzazione collegata all'account di fatturazione.

soldTo

SoldTo

Indirizzo dell'utente o dell'organizzazione responsabile dell'account di fatturazione.

taxIds

TaxIdentifier[]

Elenco di identificatori fiscali per l'account di fatturazione.

BillingAccountStatusReasonCode

Motivo dello stato dell'account di fatturazione specificato.

Nome Tipo Descrizione
Expired

string

ManuallyTerminated

string

Other

string

TerminateProcessing

string

Transferred

string

UnusualActivity

string

BillingRelationshipType

Identifica le relazioni di fatturazione rappresentate da un account di fatturazione. La relazione di fatturazione può essere tra Microsoft, il cliente e/o una terza parte.

Nome Tipo Descrizione
CSPCustomer

string

CSPPartner

string

Direct

string

IndirectCustomer

string

IndirectPartner

string

Other

string

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

EnrollmentDetails

Proprietà di una registrazione.

Nome Tipo Descrizione
billingCycle

string

Ciclo di fatturazione per la registrazione.

channel

string

Tipo di canale della registrazione.

cloud

string

Cloud della registrazione.

countryCode

string

Codice paese della registrazione.

currency

string

Valuta di fatturazione per la registrazione.

endDate

string

Data di fine della registrazione.

extendedTermOption

ExtendedTermOption

L'estensione dell'account di fatturazione è stata scelta dall'azienda.

indirectRelationshipInfo

IndirectRelationshipInfo

Proprietà di una registrazione applicabili solo per le registrazioni indirette.

invoiceRecipient

string

Contatto che riceve le fatture della registrazione.

language

string

Lingua per la registrazione.

markupStatus

MarkupStatus

Stato di markup della registrazione, applicabile solo per le registrazioni indirette.

poNumber

string

Numero di ordine di acquisto della registrazione.

startDate

string

Data di inizio della registrazione.

supportCoverage

string

Periodo di copertura del supporto per la registrazione.

supportLevel

SupportLevel

Offerta a livello di supporto associata a una registrazione.

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ExtendedTermOption

L'estensione dell'account di fatturazione è stata scelta dall'azienda.

Nome Tipo Descrizione
Opted-In

string

Opted-Out

string

Other

string

IndirectRelationshipInfo

Identifica il profilo di fatturazione collegato a un altro profilo di fatturazione nel movimento di acquisto indiretto.

Nome Tipo Descrizione
billingAccountName

string

Nome dell'account di fatturazione del partner o del cliente per un movimento indiretto.

billingProfileName

string

Nome del profilo di fatturazione del partner o del cliente per un movimento indiretto.

displayName

string

Nome visualizzato del partner o del cliente per un movimento indiretto.

MarkupStatus

Stato di markup della registrazione, applicabile solo per le registrazioni indirette.

Nome Tipo Descrizione
Disabled

string

Locked

string

Other

string

Preview

string

Published

string

PaymentTerm

Proprietà del termine di pagamento.

Nome Tipo Descrizione
endDate

string

La data in cui terminerà il termine "Termine di pagamento" definito e sarà sempre in formato UTC.

isDefault

boolean

Indica che il termine di pagamento è il termine di pagamento standard.

startDate

string

La data in cui il termine di pagamento definito sarà effettivo da e sarà sempre in formato UTC.

term

string

Rappresenta la durata in formato netXX. Sempre in giorni.

ProvisioningState

Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.

Nome Tipo Descrizione
Canceled

string

Failed

string

New

string

Pending

string

Provisioning

string

Succeeded

string

RegistrationNumber

Descrive il numero di registrazione dell'organizzazione collegata all'account di fatturazione.

Nome Tipo Descrizione
id

string

Numero di identificazione univoco dell'organizzazione collegato all'account di fatturazione.

required

boolean

Identifica se il numero di registrazione è necessario per l'account di fatturazione.

type

string[]

Tipi di numero di registrazione consentiti in base al paese dell'account di fatturazione.

SoldTo

Indirizzo dell'utente o dell'organizzazione responsabile dell'account di fatturazione.

Nome Tipo Descrizione
addressLine1

string

Riga indirizzo 1.

addressLine2

string

Riga indirizzo 2.

addressLine3

string

Riga indirizzo 3.

city

string

Indirizzo città.

companyName

string

Nome società. Facoltativo per mca individuale (con pagamento in base al consumo).

country

string

Il codice paese usa il formato ISO 3166-1 Alpha-2.

district

string

Distretto dell'indirizzo.

email

string

Indirizzo email.

firstName

string

Nome di battesimo. Facoltativo per MCA Enterprise.

isValidAddress

boolean

Indica se l'indirizzo è incompleto.

lastName

string

Cognome. Facoltativo per MCA Enterprise.

middleName

string

Secondo nome.

phoneNumber

string

Numero di telefono.

postalCode

string

Codice postale.

region

string

Area dell'indirizzo.

SupportLevel

Offerta a livello di supporto associata a una registrazione.

Nome Tipo Descrizione
Developer

string

Other

string

Pro-Direct

string

Standard

string

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione della risorsa (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.

TaxIdentifier

Identificatore fiscale per l'account di fatturazione.

Nome Tipo Descrizione
country

string

Paese dell'identificatore fiscale.

id

string

ID dell'identificatore fiscale.

scope

string

Ambito dell'identificatore fiscale.

status

TaxIdentifierStatus

Stato dell'identificatore fiscale.

type

TaxIdentifierType

Tipo dell'identificatore fiscale.

TaxIdentifierStatus

Stato dell'identificatore fiscale.

Nome Tipo Descrizione
Invalid

string

Other

string

Valid

string

TaxIdentifierType

Tipo dell'identificatore fiscale.

Nome Tipo Descrizione
BrazilCcmId

string

BrazilCnpjId

string

BrazilCpfId

string

CanadianFederalExempt

string

CanadianProvinceExempt

string

ExternalTaxation

string

IndiaFederalServiceTaxId

string

IndiaFederalTanId

string

IndiaPanId

string

IndiaStateCstId

string

IndiaStateGstINId

string

IndiaStateVatId

string

IntlExempt

string

LoveCode

string

MobileBarCode

string

NationalIdentificationNumber

string

Other

string

PublicSectorId

string

USExempt

string

VatId

string