파트너 센터 API를 사용하여 간접 재판매인에 대한 고객 만들기

아티클
03/28/2024

적용 대상: 파트너 센터

간접 공급자는 간접 재판매인에 대한 고객을 만들 수 있습니다.

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 앱 + 사용자 자격 증명을 사용한 인증만 지원합니다.
간접 재판매인의 테넌트 식별자입니다.
간접 재판매인은 간접 공급자와 파트너 관계를 맺어야 합니다.

C#

간접 재판매인에 대한 새 고객을 추가하려면 다음을 수행합니다.

새 Customer 개체를 인스턴스화한 다음 BillingProfile 및 CompanyProfile을 인스턴스화하고 채웁다. 간접 재판매인 ID를 ASSOCIATedPartnerID 속성에 할당해야 합니다.
IAggregatePartner.Customers 속성을 사용하여 고객 수집 작업에 대한 인터페이스를 가져옵니다.
Create 또는 CreateAsync 메서드를 호출하여 고객을 만듭니다.

C# 예제

// IAggregatePartner partnerOperations;
// var indirectResellerId;
var customerToCreate = new Customer()
{
    CompanyProfile = new CustomerCompanyProfile()
    {
        Domain = string.Format(CultureInfo.InvariantCulture,
            "WingtipToys{0}.{1}",
            new Random().Next(),
            this.Context.Configuration.Scenario.CustomerDomainSuffix)
    },
    BillingProfile = new CustomerBillingProfile()
    {
        Culture = "EN-US",
        Email = "Gena@wingtiptoys.com",
        Language = "En",
        CompanyName = "Wingtip Toys",
        DefaultAddress = new Address()
        {
            FirstName = "Gena",
            LastName = "Soto",
            AddressLine1 = "One Microsoft Way",
            City = "Redmond",
            State = "WA",
            Country = "US",
            PostalCode = "98052",
            PhoneNumber = "4255550101"
        }
    },
    AssociatedPartnerId = indirectResellerId
};

var newCustomer = partnerOperations.Customers.Create(customerToCreate);

샘플: 콘솔 테스트 앱. 프로젝트: 파트너 센터 SDK 샘플 클래스: CreateCustomerforIndirectReseller.cs

REST 요청

요청 구문

메서드	요청 URI
POST	{baseURL}/v1/customers HTTP/1.1

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

요청 본문

이 표에서는 요청 본문의 필수 속성을 설명합니다.

이름	Type	필수	설명
BillingProfile	개체	예	고객의 청구 프로필 정보입니다.
CompanyProfile	개체	예	회사의 프로필 정보입니다.
AssociatedPartnerId	string	예	간접 재판매인 ID입니다. 여기에 제공된 ID로 표시된 간접 재판매인은 간접 공급자와 파트너 관계를 맺어야 합니다. 그렇지 않으면 요청이 실패합니다. 또한 ASSOCIATedPartnerId 값이 제공되지 않으면 고객은 간접 재판매인이 아닌 간접 공급자의 직접 고객으로 만들어집니다.
도메인	문자열	예	contoso.onmicrosoft.com와 같은 고객 도메인 이름입니다.
organizationRegistrationNumber	string	예	고객의 조직 등록 번호(특정 국가/지역의 INN 번호라고도 함)입니다. 아르메니아(AM), 아제르바이잔(AZ), 벨라루스(BY), 헝가리(HU), 카자흐스탄(KZ), 키르기스스탄(KG), 몰도바(MD), 러시아(RU), 타지키스탄(TJ), 우즈베키스탄(UZ), 우크라이나(UA), 인도, 인도 브라질, 남아프리카 공화국, 폴란드, 아랍에미리트, 사우디아라비아, 튀르키예, 태국, 베트남, 미얀마, 이라크, 남수단 및 베네수엘라. 다른 국가/지역에 있는 고객의 회사/조직의 경우 선택적 필드입니다.

청구 프로필

이 표에서는 새 고객을 만드는 데 필요한 CustomerBillingProfile 리소스의 최소 필수 필드를 설명합니다.

속성	Type	필수	설명
이메일	string	예	고객 이메일 주소입니다.
culture	string	예	통신 및 통화에 대한 선호 문화(예: `en-US`. 지원되는 문화권에 대해서는 파트너 센터에서 지원되는 언어 및 로캘을 참조하세요.
언어	string	예	기본 언어입니다. 두 문자 언어 코드(예 `en` : 또는 `fr`)가 지원됩니다.
company_name	string	예	등록된 회사/조직 이름입니다.
default_address	주소	예	고객 회사/조직의 등록된 주소입니다. 길이 제한에 대한 자세한 내용은 주소 리소스를 참조하세요.

회사 프로필

이 표에서는 새 고객을 만드는 데 필요한 CustomerCompanyProfile 리소스의 최소 필수 필드를 설명합니다.

속성	Type	필수	설명
도메인	string	예	contoso.onmicrosoft.com와 같은 고객 도메인 이름입니다.
organizationRegistrationNumber	string	조건에 따라 다름	고객의 조직 등록 번호(특정 국가/지역의 INN 번호라고도 함). 이 필드를 완료하려면 고객의 회사/조직이 다음 국가/지역에 있는 경우에만 필요합니다. - 아르메니아(AM) - 아제르바이잔어(AZ) - 벨라루스 (BY) - 헝가리(HU) - 카자흐스탄(KZ) - 키르기스스탄(KG) - 몰도바(MD) - 러시아(RU) - 타지키스탄 (TJ) - 우즈베키스탄(UZ) - 우크라이나 (UA) -인도 -브라질 -남아프리카 공화국 -폴란드 -아랍 에미리트 연합국 -사우디아라비아 - Türkiye -태국 -베트남 -미얀마 -이라크 - 남수단 -베네수엘라 -중국 다른 국가/지역에 있는 고객의 회사/조직의 경우 선택적 필드입니다.

기본적으로 GDAP

속성	형식	설명
enableGDAPByDefault	bool	기본적으로 GDAP를 사용하도록 설정할지 여부를 나타내는 부울입니다. true이면 기본적으로 GDAP를 만듭니다. false이면 GDAP를 만들지 않습니다. GDAP를 지원하는 클라우드에서만 적용됩니다. 지원되지 않는 경우 DAP는 기본적으로 만들어집니다.

요청 예시

POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: d628adbe-b7ee-412e-ac55-58f22b4ba2f4
MS-CorrelationId: 0dd197a8-992c-44ca-aeae-21cd83494dce
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 823
Expect: 100-continue
Connection: Keep-Alive

{
    "enableGDAPByDefault": false,
    "Id": null,
    "CommerceId": null,
    "CompanyProfile": {
        "TenantId": null,
        "Domain": "WingtipToys678152504.onmicrosoft.com",
        "CompanyName": null,
        "Attributes": {
            "ObjectType": "CustomerCompanyProfile"
        }
    },
    "BillingProfile": {
        "Id": null,
        "FirstName": null,
        "LastName": null,
        "Email": "Gena@wingtiptoys.com",
        "Culture": "EN-US",
        "Language": "En",
        "CompanyName": "Wingtip Toys",
        "DefaultAddress": {
            "Country": "US",
            "Region": null,
            "City": "Redmond",
            "State": "WA",
            "AddressLine1": "One Microsoft Way",
            "AddressLine2": null,
            "PostalCode": "98052",
            "FirstName": "Gena",
            "LastName": "Soto",
            "PhoneNumber": "4255550101"
        },
        "Attributes": {
            "ObjectType": "CustomerBillingProfile"
        }
    },
    "RelationshipToPartner": "none",
    "AllowDelegatedAccess": null,
    "UserCredentials": null,
    "CustomDomains": null,
    "AssociatedPartnerId": "484e548c-f5f3-4528-93a9-c16c6373cb59",
    "Attributes": {
        "ObjectType": "Customer"
    }
}

Important

2023년 6월 현재 최신 파트너 센터 .NET SDK 릴리스 3.4.0이 보관됩니다. 유용한 정보가 포함된 추가 정보 파일과 함께 GitHub에서 SDK 릴리스를 다운로드할 수 있습니다.

파트너는 파트너 센터 REST API를 계속 사용하는 것이 좋습니다.

REST 응답

성공하면 응답에 새 고객에 대한 고객 리소스가 포함됩니다.

응답 성공 및 오류 코드

응답에는 성공 또는 실패 및 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.

응답 예제

HTTP/1.1 201 Created
Content-Length: 1085
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 0dd197a8-992c-44ca-aeae-21cd83494dce
MS-RequestId: d628adbe-b7ee-412e-ac55-58f22b4ba2f4
MS-CV: Yy/YaA0gYEmfQyR/.0
MS-ServerId: 030020525
Date: Tue, 06 Jun 2017 23:11:40 GMT

{
    "enableGDAPByDefault": false,
    "id": "626099fe-17af-4756-9fd0-6a73b7127859",
    "commerceId": "626099fe-17af-4756-9fd0-6a73b7127859",
    "companyProfile": {
        "tenantId": "626099fe-17af-4756-9fd0-6a73b7127859",
        "domain": "WingtipToys678152504.onmicrosoft.com",
        "companyName": "Wingtip Toys",
        "links": {
            "self": {
                "uri": "/customers/626099fe-17af-4756-9fd0-6a73b7127859/profiles/company",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "CustomerCompanyProfile"
        }
    },
    "billingProfile": {
        "id": "7079246e-7b62-56ef-7cbd-a819514b54b5",
        "email": "Gena@wingtiptoys.com",
        "culture": "en-US",
        "language": "En",
        "companyName": "Wingtip Toys",
        "defaultAddress": {
            "country": "US",
            "city": "Redmond",
            "state": "WA",
            "addressLine1": "One Microsoft Way",
            "postalCode": "98052",
            "firstName": "Gena",
            "lastName": "Soto",
            "phoneNumber": "4255550101"
        },
        "attributes": {
            "etag": "-8799889149591823008",
            "objectType": "CustomerBillingProfile"
        }
    },
    "relationshipToPartner": "reseller",
    "allowDelegatedAccess": true,
    "userCredentials": {
        "userName": "admin",
        "password": "0Krha*Io"
    },
    "associatedPartnerId": "484e548c-f5f3-4528-93a9-c16c6373cb59",
    "attributes": {
        "objectType": "Customer"
    }
}

다음을 통해 공유