Compartir a través de

Obtener las transferencias de un cliente

  • Artículo

Cómo obtener una lista de las transferencias de un cliente.

Roles adecuados: Agente de administración | Agente de ventas

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 independiente y app+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 , luego 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).

Sintaxis de la solicitud

Método URI de solicitud
GET {baseURL}/v1/customers/{customer-tenant-id}/transfers HTTP/1.1

Parámetro de URI

En esta tabla se muestra el parámetro de consulta necesario para obtener todas las suscripciones.

Nombre Type Obligatorio Descripción
customer-tenant-id string Sí Cadena con formato de GUID que identifica al cliente.

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 /v1/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca2cdd2c-7eb8-4a2e-cdd7-2848752e801a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Connection: Keep-Alive

Respuesta REST

Si se ejecuta correctamente, este método devuelve una lista de recursos TransferEntity en el cuerpo de la respuesta.

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: 13828
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ca2cdd2c-7eb8-4a2e-cdd7-2848752e801a
Date: Fri, 27 Mar 2020 17:50:34 GMT

[
  {
    "id": "ab724652-3442-4912-8615-61525bb9903d",
    "status": "Reject",
    "createdTime": "2019-10-09T22:44:13.5411441Z",
    "lastModifiedTime": "2020-02-20T21:27:59Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "B4D4B7F4-4089-43B6-9C44-DE97B760FB11",
        "billingCycle": "monthly",
        "friendlyName": "Visio Online Plan 2",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "addonItems": [

        ]
      },
      {
        "id": 0,
        "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "offerId": "13D32E13-A1B0-400D-96C0-4EAAA14DCED5",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 for Supply Chain Management Attach to Qualifying Dynamics 365 Base Offer (Qualified Offer)",
        "quantity": 20,
        "partnerIdOnRecord": "5139005",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ab724652-3442-4912-8615-61525bb9903d",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "38a00d97-421c-4c33-8ae4-c8750604e02c",
    "status": "Complete",
    "createdTime": "2020-02-20T21:16:30.0149083Z",
    "lastModifiedTime": "2020-02-27T01:11:33Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
        "offerId": "5E1087B6-246B-4503-B88A-B60BDF0B3840",
        "orderId": "5761e79a-f441-4a18-9902-83f9582ccff6",
        "billingCycle": "monthly",
        "friendlyName": "PowerApps per app plan",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 0,
        "subscriptionId": "dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
        "offerId": "91FD106F-4B2C-4938-95AC-F54F74E9A239",
        "orderId": "9a088a06-dfe5-4f71-ba79-2711c313b634",
        "billingCycle": "monthly",
        "friendlyName": "Office 365 E1",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 0,
        "subscriptionId": "eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c",
        "offerId": "MS-AZR-0145P",
        "orderId": "6a9a544c-54c9-43e9-a863-b40c6f92d111",
        "billingCycle": "monthly",
        "friendlyName": "Microsoft Azure",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "2",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/38a00d97-421c-4c33-8ae4-c8750604e02c",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "d4f478d2-61e0-4550-b85d-c427abfe1e62",
    "status": "Complete",
    "createdTime": "2020-02-20T21:28:55.4245587Z",
    "lastModifiedTime": "2020-02-20T21:29:22Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "B4D4B7F4-4089-43B6-9C44-DE97B760FB11",
        "orderId": "2340952e-af72-40e6-a106-e9b2aca99bb5",
        "billingCycle": "monthly",
        "friendlyName": "Visio Online Plan 2",
        "quantity": 2,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 0,
        "subscriptionId": "ffff5f5f-aa6a-bb7b-cc8c-dddddd9d9d9d",
        "offerId": "F1A2FDB0-5CA8-475D-8CCC-9BB81C033DA5",
        "orderId": "5dd120ab-10a4-4bbf-b2bd-e52657431f85",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 for Project Service Automation (Qualified Offer) (250 seat minimum requirement)",
        "quantity": 250,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/d4f478d2-61e0-4550-b85d-c427abfe1e62",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "f10421cd-d4af-4939-82b9-cd0e75022759",
    "status": "PartiallyComplete",
    "createdTime": "2020-02-26T21:54:51.2901506Z",
    "lastModifiedTime": "2020-02-27T01:10:26Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "B4D4B7F4-4089-43B6-9C44-DE97B760FB11",
        "billingCycle": "monthly",
        "friendlyName": "Visio Online Plan 2",
        "quantity": 2,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Failed",
        "addonItems": [

        ],
        "transferError": "Subscription has already been transfered. Subscription: aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
      },
      {
        "id": 0,
        "subscriptionId": "aaaa6a6a-bb7b-cc8c-dd9d-eeeeee0e0e0e",
        "offerId": "1B4642E5-C69A-43EA-B4F6-F29BAE46227E",
        "orderId": "0e6793f0-3d9c-4749-b50d-1cf3527aa454",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 for Retail Attach to Qualifying Dynamics 365 Base Offer From SA From VL/DPL",
        "quantity": 20,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/f10421cd-d4af-4939-82b9-cd0e75022759",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "ddb933ad-02f4-4678-a09a-7fecca481acc",
    "status": "Reject",
    "createdTime": "2020-03-11T17:44:26.8841412Z",
    "lastModifiedTime": "2020-03-11T17:45:08Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "01a7548d-1136-4cf0-ba9a-300f921ffb22",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "5B04B78C-FD36-4CF3-A7A5-3457991C8B79",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 Business Central Device",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "addonItems": [

        ]
      },
      {
        "id": 1,
        "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "offerId": "MS-AZR-0145P",
        "billingCycle": "monthly",
        "friendlyName": "Microsoft Azure",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ddb933ad-02f4-4678-a09a-7fecca481acc",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "0a25bd0e-e6c1-40ac-9e96-40b56d46e902",
    "status": "Complete",
    "createdTime": "2020-03-11T17:56:53.622599Z",
    "lastModifiedTime": "2020-03-11T17:58:00Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "5B04B78C-FD36-4CF3-A7A5-3457991C8B79",
        "orderId": "42436b2f-d417-4642-bb76-feb697184100",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 Business Central Device",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 1,
        "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "offerId": "MS-AZR-0145P",
        "orderId": "d9a1b396-ad2c-4283-a9fe-5490acd0ce7d",
        "billingCycle": "monthly",
        "friendlyName": "Microsoft Azure",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/0a25bd0e-e6c1-40ac-9e96-40b56d46e902",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "8dc673dd-d6a6-4739-9e8f-0b66bbf2a2c8",
    "status": "Complete",
    "createdTime": "2020-03-19T23:21:03.2754503Z",
    "lastModifiedTime": "2020-03-19T23:22:33Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "3badf44d-fd41-4432-a17d-214e31f2d9ee",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
        "offerId": "3DD9350B-27D6-4501-93A4-C8D107F1DE47",
        "orderId": "31bfde4a-efca-49b2-b210-62973fb773db",
        "billingCycle": "monthly",
        "friendlyName": "Microsoft Flow Plan 1 (Qualified Offer)",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/8dc673dd-d6a6-4739-9e8f-0b66bbf2a2c8",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "ac4a9d22-ba07-444e-890f-cfe084eed498",
    "status": "Reject",
    "createdTime": "2020-03-25T22:05:25.1057725Z",
    "lastModifiedTime": "2020-03-27T17:50:32Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "01a7548d-1136-4cf0-ba9a-300f921ffb22",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "offerId": "13D32E13-A1B0-400D-96C0-4EAAA14DCED5",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 for Supply Chain Management Attach to Qualifying Dynamics 365 Base Offer (Qualified Offer)",
        "quantity": 20,
        "partnerIdOnRecord": "5139005",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ac4a9d22-ba07-444e-890f-cfe084eed498",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "7b1ce5e6-5829-45c6-b3bb-89bfb791a69e",
    "status": "PartiallyComplete",
    "createdTime": "2020-03-25T22:20:38.8090876Z",
    "lastModifiedTime": "2020-03-25T22:24:35Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
        "offerId": "5344C201-3099-44E5-B333-C3EB0401EDE0",
        "orderId": "21b92393-ffce-4bc7-87c5-62cfa897d8f9",
        "billingCycle": "annual",
        "friendlyName": "Dynamics 365 Customer Engagement Plan (36 mo)",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 1,
        "subscriptionId": "eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c",
        "offerId": "A4179D30-CC09-49F0-977E-DC2CB70B874F",
        "billingCycle": "annual",
        "friendlyName": "Project Online Essentials",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Failed",
        "addonItems": [

        ],
        "transferError": "Subscription SyncState must be SyncComplete for the Subscription to be a source in a Subscription Ownership Transfer. Subscription: eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c, current state: None"
      },
      {
        "id": 2,
        "subscriptionId": "ffff5f5f-aa6a-bb7b-cc8c-dddddd9d9d9d",
        "offerId": "1A90EE13-2CB4-4785-BB0F-542813F00A37",
        "orderId": "7414b8ea-c167-4cc4-bc8e-b43efc177a46",
        "billingCycle": "annual",
        "friendlyName": "Dynamics 365 Business Central Essential",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "2",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/7b1ce5e6-5829-45c6-b3bb-89bfb791a69e",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  }
]