Obtener el resumen del costo del servicio al cliente
Obtiene los costos de servicio de un cliente para el período de facturación especificado.
Requisitos previos
Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación y usuario.
Un id. de cliente (
customer-tenant-id
). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , el cliente de la lista de clientes y, a continuación, Cuenta. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id
).Indicador de período de facturación (
mostrecent
).
C#
Para recuperar un resumen de costos de servicio para el cliente especificado:
Llame al método IAggregatePartner.Customers.ById con el identificador de cliente para identificar al cliente.
Utilice la propiedad ServiceCosts para obtener una interfaz para las operaciones de recopilación de costos de servicio al cliente.
Llame al método ByBillingPeriod con un miembro de la enumeración ServiceCostsBillingPeriod para devolver una IServiceCostsCollection.
Use el método IServiceCostsCollection.Summary.Get o GetAsync para obtener el resumen de costos de servicio del cliente.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
var serviceCostsSummary = partnerOperations.Customers.ById(selectedCustomerId).ServiceCosts.ByBillingPeriod(ServiceCostsBillingPeriod.MostRecent).Summary.Get();
Solicitud REST
Sintaxis de la solicitud
Método | URI de la solicitud |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/servicecosts/{billing-period} HTTP/1.1 |
Parámetros del identificador URI
Use los siguientes parámetros de ruta de acceso para identificar el cliente y el período de facturación.
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
customer-id | guid | Sí | Identificador de cliente con formato GUID que identifica al cliente. |
billing-period | string | Sí | Indicador que representa el período de facturación. El único valor admitido es MostRecent. El caso de la cadena no importa. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Cuerpo de la solicitud
Ninguno.
Ejemplo de solicitud
GET https://api.partnercenter.microsoft.com/v1/customers/65726577-c208-40fd-9735-8c85ac9cac68/servicecosts/mostrecent HTTP/1.1
Authorization: Bearer <authorization token>
Accept: application/json
MS-RequestId: e6a3b6b2-230a-4813-999d-57f883b60d38
MS-CorrelationId: a687bc47-8d08-4b78-aff6-5a59aa2055c2
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Respuesta REST
Si se ejecuta correctamente, el cuerpo de la respuesta contiene un recurso ServiceCostsSummary que proporciona información sobre los costos del servicio.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.
Ejemplo de respuesta
HTTP/1.1 200 OK
Content-Length: 766
Content-Type: application/json; charset=utf-8
MS-CorrelationId: a687bc47-8d08-4b78-aff6-5a59aa2055c2
MS-RequestId: e6a3b6b2-230a-4813-999d-57f883b60d38
MS-CV: gPPoyNX1X0asAAcw.0
MS-ServerId: 101112202
Date: Fri, 02 Dec 2016 18: 54: 38 GMT
{
"billingStartDate": "2015-12-12T00:00:00Z",
"billingEndDate": "2016-01-11T00:00:00Z",
"pretaxTotal": 17.22,
"tax": 0.0,
"afterTaxTotal": 17.22,
"currencySymbol": "$",
"customerId": "ae1d5b32-f9ff-4252-b2bf-40e21937a51a",
"details":
[
{
"invoiceType": "Recurring",
"summary": {
"billingStartDate": "2015-12-12T00:00:00Z",
"billingEndDate": "2016-01-11T00:00:00Z",
"pretaxTotal": 17.22,
"tax": 0.0,
"afterTaxTotal": 17.22,
"currencyCode": "USD",
"currencySymbol": "$",
"customerId": "ae1d5b32-f9ff-4252-b2bf-40e21937a51a",
"links": {},
"attributes": {
"objectType": "ServiceCostsSummary"
}
}
},
{
"invoiceType": "OneTime",
"summary": {
"billingStartDate": "2019-04-01T00:00:00Z",
"billingEndDate": "2019-04-30T23:59:59.9999999Z",
"pretaxTotal": 2,
"tax": 0.2,
"afterTaxTotal": 2.2,
"currencyCode": "USD",
"currencySymbol": "$",
"customerId": "ae1d5b32-f9ff-4252-b2bf-40e21937a51a",
"links": {},
"attributes": {
"objectType": "ServiceCostsSummary"
}
}
}
],
"links": {
"serviceCostLineItems": {
"uri": "/customers/ae1d5b32-f9ff-4252-b2bf-40e21937a51a/servicecosts/MostRecent/lineitems",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/ae1d5b32-f9ff-4252-b2bf-40e21937a51a/servicecosts/MostRecent",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "ServiceCostsSummary"
}
}
Comentaris
https://aka.ms/ContentUserFeedback.
Properament: al llarg del 2024 eliminarem gradualment GitHub Issues com a mecanisme de retroalimentació del contingut i el substituirem per un nou sistema de retroalimentació. Per obtenir més informació, consulteu:Envieu i consulteu els comentaris de