Partilhar via


Billing Accounts - Add Payment Terms

Adiciona condições de pagamento a todos os perfis de cobrança na conta de cobrança. Atualmente, os termos de pagamento só podem ser adicionados em contas de cobrança que tenham Tipo de Contrato como "Contrato de Cliente Microsoft" e Tipo de Conta como "Empresa". Esta ação necessita de pré-autorização e apenas os Vendedores de Campo estão autorizados a adicionar as condições de pagamento e não é uma ação de autosserviço.

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

Parâmetros do URI

Name Em Necessário Tipo Description
billingAccountName
path True

string

O ID que identifica exclusivamente uma conta de cobrança.

Padrão Regex: ^([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

A versão da API a ser usada com a solicitação do cliente. A versão atual é 2024-04-01.

Corpo do Pedido

Name Tipo Description
parameters

PaymentTerm[]

As propriedades do prazo de pagamento.

Respostas

Name Tipo Description
200 OK

BillingAccount

A lista de contas de cobrança.

202 Accepted

Um resultado aceito da operação que retorna um cabeçalho 'Local' que o cliente pode sondar para exibir o resultado da operação.

Cabeçalhos

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

ErrorResponse

Resposta de erro descrevendo por que a operação falhou.

Exemplos

PaymentTermsAdd

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
AccountStatus

O status atual da conta de cobrança.

AccountSubType

O nível da conta.

AccountType

O tipo de cliente.

AgreementType

O tipo de acordo.

BillingAccount

Uma conta de faturação.

BillingAccountProperties

Uma conta de faturação.

BillingAccountStatusReasonCode

Motivo para o status da conta de faturamento especificado.

BillingRelationshipType

Identifica as relações de faturamento representadas por uma conta de faturamento. A relação de cobrança pode ser entre a Microsoft, o cliente e/ou um terceiro.

createdByType

O tipo de identidade que criou o recurso.

EnrollmentDetails

As propriedades de uma inscrição.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ExtendedTermOption

A extensão da conta de faturação optada pela empresa.

IndirectRelationshipInfo

Identifica o perfil de faturamento vinculado a outro perfil de faturamento no movimento de compra indireta.

MarkupStatus

Status de marcação da inscrição, aplicável apenas para inscrições indiretas.

PaymentTerm

As propriedades do prazo de pagamento.

ProvisioningState

O estado de provisionamento do recurso durante uma operação de longa duração.

RegistrationNumber

Descreve o número de registro da organização vinculado à conta de cobrança.

SoldTo

O endereço do indivíduo ou organização responsável pela conta de cobrança.

SupportLevel

A oferta de nível de suporte associada a uma inscrição.

systemData

Metadados referentes à criação e última modificação do recurso.

TaxIdentifier

Um identificador fiscal para a conta de cobrança.

TaxIdentifierStatus

O status do identificador de imposto.

TaxIdentifierType

O tipo do identificador de imposto.

AccountStatus

O status atual da conta de cobrança.

Name Tipo Description
Active

string

Deleted

string

Disabled

string

Expired

string

Extended

string

New

string

Other

string

Pending

string

Terminated

string

Transferred

string

UnderReview

string

AccountSubType

O nível da conta.

Name Tipo Description
Enterprise

string

Individual

string

None

string

Other

string

Professional

string

AccountType

O tipo de cliente.

Name Tipo Description
Business

string

ClassicPartner

string

Enterprise

string

Individual

string

Internal

string

Other

string

Partner

string

Reseller

string

Tenant

string

AgreementType

O tipo de acordo.

Name Tipo Description
EnterpriseAgreement

string

MicrosoftCustomerAgreement

string

MicrosoftOnlineServicesProgram

string

MicrosoftPartnerAgreement

string

Other

string

BillingAccount

Uma conta de faturação.

Name Tipo Description
id

string

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties

BillingAccountProperties

Uma conta de faturação.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

tags

object

Dicionário de metadados associados ao recurso. Ele pode não ser preenchido para todos os tipos de recursos. Comprimento máximo de chave/valor suportado de 256 caracteres. Chaves/valor não devem esvaziar valor nem nulo. As chaves não podem conter <> % & \ ? /

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

BillingAccountProperties

Uma conta de faturação.

Name Tipo Description
accountStatus

AccountStatus

O status atual da conta de cobrança.

accountStatusReasonCode

BillingAccountStatusReasonCode

Motivo para o status da conta de faturamento especificado.

accountSubType

AccountSubType

O nível da conta.

accountType

AccountType

O tipo de cliente.

agreementType

AgreementType

O tipo de acordo.

billingRelationshipTypes

BillingRelationshipType[]

Identifica as relações de faturamento representadas por uma conta de faturamento. A relação de cobrança pode ser entre a Microsoft, o cliente e/ou um terceiro.

displayName

string

O nome da conta de cobrança.

enrollmentDetails

EnrollmentDetails

As propriedades de uma inscrição.

hasNoBillingProfiles

boolean

Indica se a conta de cobrança tem ou não perfis de cobrança.

hasReadAccess

boolean

Indica se o usuário tem acesso de leitura à conta de cobrança.

notificationEmailAddress

string

Endereço de e-mail de notificação para conta herdada. Disponível para o tipo de contrato Programa Microsoft Online Services.

primaryBillingTenantId

string

O inquilino que foi utilizado para configurar a conta de faturação. Por padrão, apenas os usuários desse locatário podem obter atribuições de função na conta de cobrança e todas as compras são provisionadas nesse locatário.

provisioningState

ProvisioningState

O estado de provisionamento do recurso durante uma operação de longa duração.

qualifications

string[]

Qualificações para a definição de preços de uma conta de faturação. Os valores podem ser Comerciais, Educacionais, Beneficentes ou Governamentais.

registrationNumber

RegistrationNumber

Descreve o número de registro da organização vinculado à conta de cobrança.

soldTo

SoldTo

O endereço do indivíduo ou organização responsável pela conta de cobrança.

taxIds

TaxIdentifier[]

Uma lista de identificadores fiscais para a conta de cobrança.

BillingAccountStatusReasonCode

Motivo para o status da conta de faturamento especificado.

Name Tipo Description
Expired

string

ManuallyTerminated

string

Other

string

TerminateProcessing

string

Transferred

string

UnusualActivity

string

BillingRelationshipType

Identifica as relações de faturamento representadas por uma conta de faturamento. A relação de cobrança pode ser entre a Microsoft, o cliente e/ou um terceiro.

Name Tipo Description
CSPCustomer

string

CSPPartner

string

Direct

string

IndirectCustomer

string

IndirectPartner

string

Other

string

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

EnrollmentDetails

As propriedades de uma inscrição.

Name Tipo Description
billingCycle

string

O ciclo de faturamento da inscrição.

channel

string

O tipo de canal da inscrição.

cloud

string

A nuvem da inscrição.

countryCode

string

O código do país da inscrição.

currency

string

A moeda de cobrança da inscrição.

endDate

string

A data final da inscrição.

extendedTermOption

ExtendedTermOption

A extensão da conta de faturação optada pela empresa.

indirectRelationshipInfo

IndirectRelationshipInfo

As propriedades de uma inscrição que são aplicáveis apenas para inscrições indiretas.

invoiceRecipient

string

O contato que recebe as faturas da inscrição.

language

string

O idioma para a inscrição.

markupStatus

MarkupStatus

Status de marcação da inscrição, aplicável apenas para inscrições indiretas.

poNumber

string

O número da ordem de compra da inscrição.

startDate

string

A data de início da inscrição.

supportCoverage

string

O período de cobertura de suporte para a inscrição.

supportLevel

SupportLevel

A oferta de nível de suporte associada a uma inscrição.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

ExtendedTermOption

A extensão da conta de faturação optada pela empresa.

Name Tipo Description
Opted-In

string

Opted-Out

string

Other

string

IndirectRelationshipInfo

Identifica o perfil de faturamento vinculado a outro perfil de faturamento no movimento de compra indireta.

Name Tipo Description
billingAccountName

string

O nome da conta de faturamento do parceiro ou do cliente para um movimento indireto.

billingProfileName

string

O nome do perfil de faturamento do parceiro ou do cliente para uma movimentação indireta.

displayName

string

O nome de exibição do parceiro ou cliente para um movimento indireto.

MarkupStatus

Status de marcação da inscrição, aplicável apenas para inscrições indiretas.

Name Tipo Description
Disabled

string

Locked

string

Other

string

Preview

string

Published

string

PaymentTerm

As propriedades do prazo de pagamento.

Name Tipo Description
endDate

string

A data em que o 'Prazo de Pagamento' definido terminará e está sempre em UTC.

isDefault

boolean

Indica que o prazo de pagamento é o termo de pagamento padrão.

startDate

string

A data em que o 'Prazo de Pagamento' definido entrará em vigor e está sempre em UTC.

term

string

Representa a duração no formato netXX. Sempre em dias.

ProvisioningState

O estado de provisionamento do recurso durante uma operação de longa duração.

Name Tipo Description
Canceled

string

Failed

string

New

string

Pending

string

Provisioning

string

Succeeded

string

RegistrationNumber

Descreve o número de registro da organização vinculado à conta de cobrança.

Name Tipo Description
id

string

O número de identificação único da organização associado à conta de faturação.

required

boolean

Identifica se o número de registro é necessário para a conta de cobrança.

type

string[]

Os tipos de número de registo permitidos com base no país da conta de faturação.

SoldTo

O endereço do indivíduo ou organização responsável pela conta de cobrança.

Name Tipo Description
addressLine1

string

Endereço linha 1.

addressLine2

string

Endereço linha 2.

addressLine3

string

Endereço linha 3.

city

string

Cidade do endereço.

companyName

string

Nome da empresa. Opcional para MCA Individual (Pay-as-you-go).

country

string

O código do país utiliza o formato ISO 3166-1 Alpha-2.

district

string

Endereço distrito.

email

string

Endereço de e-mail.

firstName

string

Nome próprio. Opcional para MCA Enterprise.

isValidAddress

boolean

Indica se o endereço está incompleto.

lastName

string

Apelido. Opcional para MCA Enterprise.

middleName

string

Nome do meio.

phoneNumber

string

Número de telefone.

postalCode

string

Código postal.

region

string

Região de endereço.

SupportLevel

A oferta de nível de suporte associada a uma inscrição.

Name Tipo Description
Developer

string

Other

string

Pro-Direct

string

Standard

string

systemData

Metadados referentes à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

TaxIdentifier

Um identificador fiscal para a conta de cobrança.

Name Tipo Description
country

string

O país do identificador fiscal.

id

string

A ID do identificador de imposto.

scope

string

O escopo do identificador de imposto.

status

TaxIdentifierStatus

O status do identificador de imposto.

type

TaxIdentifierType

O tipo do identificador de imposto.

TaxIdentifierStatus

O status do identificador de imposto.

Name Tipo Description
Invalid

string

Other

string

Valid

string

TaxIdentifierType

O tipo do identificador de imposto.

Name Tipo Description
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