Konten

Festlegen eines Kontoinhabers

Um den Kontoinhaber festzulegen, kann der Aufrufer das initialAccountHolder-Attribut in den Anforderungs-Nutzdaten verwenden. Alternativ kann der Aufrufer das accountHolder-Attribut zusammen mit einem Einschluss verwenden, der eine AccountContact-Ressource enthält. Der letztere Ansatz beinhaltet den Anforderungseinschluss. Weitere Informationen finden Sie unter Anforderungseinschluss.

Beim Festlegen eines Kontoinhabers muss der Aufrufer Werte für die Felder contactSubtype, primaryAddress.addressLine1, primaryAddress.city, primaryAddress.state und primaryAddress.postalCode angeben. Wenn das Konto für eine Einzelperson bestimmt ist, muss der Aufrufer auch die Felder firstName und lastName einschließen. Wenn das Konto für ein Unternehmen bestimmt ist, muss der Aufrufer das Feld companyName einschließen.

Im folgenden Beispiel werden die erforderlichen Felder für einen einzelnen Kontoinhaber an das initialAccountHolder-Attribut angehängt:

{
  "data": {
    "attributes": {
      "initialAccountHolder": {
        "contactSubtype": "Person",
        "firstName": "Bill",
        "lastName": "Preston",
        "primaryAddress": {
          "addressLine1": "2850 S. Delaware St.",
          "city": "San Mateo",
          "postalCode": "94403",
          "state": {
            "code": "CA"
          }
        }
      },
      . . .
    }
  }
}

Im nächsten Beispiel wird veranschaulicht, wie der Kontoinhaber für dieselbe Person mithilfe des accountHolder-Attributs mit einem AccountContact-Einschluss festgelegt wird:

{
  "data": {
    "attributes": {
      "accountHolder": {
        "refid": "newperson"
      },
      . . .
    }
  },
  "included": {
    "AccountContact": [
      {
        "attributes": {
          "contactSubtype": "Person",
          "firstName": "Bill",
          "lastName": "Preston",
          "primaryAddress": {
            "addressLine1": "2850 S. Delaware St.",
            "city": "San Mateo",
            "postalCode": "94403",
            "state": {
              "code": "CA"
            }
          }
        },
        "method": "post",
        "refid": "newperson",
        "uri": "/account/v1/accounts/this/contacts"
      }
    ]
  }
}

Im nächsten Beispiel wird veranschaulicht, wie der Kontoinhaber für ein Unternehmen mithilfe des initialAccountHolder-Attributs festgelegt wird:

{
  "data": {
    "attributes": {
      "initialAccountHolder": {
        "contactSubtype": "Company",
        "companyName": "Preston, Inc.",
        "primaryAddress": {
          "addressLine1": "2850 S. Delaware St.",
          "city": "San Mateo",
          "postalCode": "94403",
          "state": {
            "code": "CA"
          }
        }
      },
      . . .
    }
  }
}

Festlegen eines spezifischen Kontostandorts

Beim Festlegen eines spezifischen Standorts muss der Aufrufer Werte für die Felder addressLine1, city, state und postalCode angeben. Im folgenden Beispiel werden diese Felder an das initialPrimaryLocation-Attribut angehängt:

{
  "data": {
    "attributes": {
      . . .
      "initialPrimaryLocation": {
        "addressLine1": "2850 S. Delaware St.",
        "city": "San Mateo",
        "state": {
          "code": "CA"
        },
        "postalCode": "94403"
      }
    }
  }
}

Im nächsten Beispiel wird dasselbe mit dem Anforderungseinschluss erreicht. Dabei wird das primaryLocation-Attribut mit einem AccountLocation-Einschluss verwendet:

{
  "data": {
    "attributes": {
      . . .
      "primaryLocation": {
        "refid": "newlocation"
      }
    }
  },
  "included": {
    "AccountLocation": [
      {
        "attributes": {
          "addressLine1": "2850 S. Delaware St.",
          "city": "San Mateo",
          "postalCode": "94403",
          "state": {
            "code": "CA"
          }
        },
        "method": "post",
        "refid": "newlocation",
        "uri": "/account/v1/accounts/this/locations"
      }
    ]
  }
}

Festlegen eines nicht spezifischen Kontostandorts

Beim Festlegen eines nicht spezifischen Standorts muss der Aufrufer Werte für die Felder state und nonSpecific angeben. Im folgenden Beispiel werden diese Felder an das initialPrimaryLocation-Attribut angehängt:

{
  "data": {
    "attributes": {
      . . .
      "initialPrimaryLocation": {
        "nonSpecific": true,
        "state": {
          "code": "CA"
        }
      }
    }
  }
}

Im nächsten Beispiel wird dasselbe mit dem Anforderungseinschluss erreicht. Dabei wird das primaryLocation-Attribut mit einem AccountLocation-Einschluss verwendet:

{
  "data": {
    "attributes": {
      . . .
      "primaryLocation": {
        "refid": "newlocation"
      }
    }
  },
  "included": {
    "AccountLocation": [
      {
        "attributes": {
          "nonSpecific": true,
          "state": {
            "code": "CA"
          }
        },
        "method": "post",
        "refid": "newlocation",
        "uri": "/account/v1/accounts/this/locations"
      }
    ]
  }
}