API ouverte d’inventaire de produits
L’API ouverte d’inventaire de produits fournit des points de terminaison permettant de créer et de récupérer des inventaires de produits.
Utilisez cette API pour gérer les informations d’inventaire des produits entre les systèmes externes et le ServiceNow AI Platform.
Cette API est incluse dans l’application Product Inventory Advanced, disponible sur le ServiceNow Store.
Cette API est fournie dans l’espace de noms sn_prd_invt .
L’utilisateur appelant doit avoir le rôle sn_prd_invt.product_inventory_integrator.
- Caractéristiques du produit [sn_prd_invt_product_characteristics]
- Inventaire des produits [sn_prd_invt_product_inventory]
- Modèle de produit [cmdb_model]
- Caractéristique du modèle de produit [sn_prd_pm_product_model_characteristic]
L’API ouverte d’inventaire de produits est une ServiceNow® implémentation de la spécification REST de l’API de gestion d’inventaire de produits TM Forum. Cette implémentation est basée sur le Guide de l’utilisateur de l’API de gestion des stocks de produits TMF637 v5.0.0, septembre 2024. L’API ouverte de l’inventaire des produits est certifiée par TM Forum.
API ouverte d’inventaire de produits – DELETE /sn_prd_invt/order/product/{id}
Supprime un enregistrement d’inventaire de produits spécifié.
Format d'URL
URL par défaut : /api/sn_prd_invt/order/product/{id}
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| id | Sys_id de l’inventaire des produits à supprimer. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| Nom | Description |
|---|---|
| Néant |
| Nom | Description |
|---|---|
| Néant |
En-têtes
Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| En-tête | Description |
|---|---|
| Néant |
Codes d'état
Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 204 | Aucun contenu. Enregistrement supprimé avec succès. |
| 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. |
Paramètres de corps de réponse (JSON)
| Nom | Description |
|---|---|
| Néant |
Demande cURL
Cet exemple supprime un enregistrement d’inventaire de produits.
curl "https://instance.service-now.com/api/sn_prd_invt/product/01b2f9972b8c72d07a83f395f291bf53" \
--request DELETE \
--header "Accept:application/json" \
--user 'username':'password'
Aucun corps de réponse n’est renvoyé lorsqu’un enregistrement d’inventaire de produits est supprimé avec succès.
API ouverte d’inventaire des produits : GET /sn_prd_invt/product
Récupère une liste de tous les inventaires de produits.
Format d'URL
URL par défaut : api/sn_prd_invt/product
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| Néant |
| Nom | Description |
|---|---|
| customer | Filtrer les inventaires de produits par client. Seules les offres de produits avec un sys_id client ou un ID externe correspondant à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne Par défaut : ne pas filtrer par client. |
| Champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Type de données : chaîne Par défaut : renvoyer tous les champs. |
| limite | Nombre maximal d’enregistrements à renvoyer. Pour les demandes qui dépassent ce nombre d’enregistrements, utilisez le paramètre pour paginer la récupération de l’enregistrement offset . Type de données : nombre Par défaut : 20 Maximum : 100 |
| décalage | Index de départ sur lequel commencer à récupérer les enregistrements. Utilisez cette valeur pour paginer la récupération de l’enregistrement. Cette fonctionnalité permet de récupérer tous les enregistrements, quel que soit leur nombre, en petits blocs gérables. Type de données : nombre Par défaut : 0 |
| lieu | Filtrer les inventaires de produits par emplacement. Type de données : objet |
| place.id | ID Sys_id ou externe de l’emplacement associé à l’enregistrement d’inventaire des produits. Type de données : chaîne Table : Emplacement [cmn_location] Champ : sys_id ou sn_tmt_core_external_id |
| état | Filtrer les inventaires de produits par état. Seuls les inventaires de produits dont l’état correspond à la valeur de ce paramètre sont renvoyés dans la réponse. Type de données : chaîne Par défaut : ne pas filtrer par statut. |
| Nom | Description |
|---|---|
| Néant |
En-têtes
Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Néant |
| En-tête | Description |
|---|---|
| Plage de contenu | Plage de contenu renvoyé dans un appel paginé. Par exemple, si |
| Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| un lien | Contient les liens suivants pour parcourir les résultats de la requête.
|
| Nombre X-Total | Pour les requêtes paginées, cet en-tête spécifie le nombre total d’enregistrements disponibles sur le serveur. |
Codes d'état
Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 200 | Demande traitée avec succès. Ressource complète renvoyée en réponse (aucune pagination). |
| 206 | Ressource partielle renvoyée en réponse (avec pagination). |
| 400 | Demande incorrecte. Raisons possibles :
|
| 404 | Enregistrement introuvable. Aucun enregistrement correspondant aux paramètres de requête n’a été trouvé dans la table. |
Paramètres de corps de réponse (JSON)
| Nom | Description |
|---|---|
| href | Lien relatif à l’enregistrement de l’inventaire des produits. Type de données : chaîne |
| id | Sys_id de l’inventaire des produits. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| nom | Nom de l’inventaire de produits. Type de données : chaîne |
| lieu | Emplacement du produit. Type de données : tableau |
| place.id | Emplacement sys_id ou ID externe. Type de données : chaîne Table : Emplacement [cmn_location] Champ : sys_id ou sn_tmt_core_external_id |
| place.name | Nom de l'emplacement. Type de données : chaîne Table : Emplacement [cmn_location] Champ : nom |
| productCaractéristique | Liste des caractéristiques du produit. Pour plus d’informations sur les caractéristiques du produit, reportez-vous à la section Create a product offering category. Type de données : tableau d’objets |
| productCharacteristic.name | Nom de la caractéristique. Type de données : chaîne |
| produitCaractéristique.valeur | Valeur de la caractéristique. Type de données : chaîne |
| productCharacteristic.valueType | Type de valeur caractéristique. Valeurs acceptées :
Type de données : chaîne |
| productId | Sys_id du modèle de produit pour l’inventaire des produits. Type de données : chaîne Table : Modèle de produit [cmdb_model] |
| productOffering | Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.id | Version initiale ou ID externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : initial_version ou external_id |
| offreproduit.identificateur interne | Version interne de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : internal_version |
| offreproduit.versioninterne | Version de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : version |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| offreproduit.version | Version externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : external_version |
| prix du produit | Renvoie un tableau vide. Type de données : tableau |
| Relation produit | Liste des produits connexes. Type de données : tableau d’objets |
| productRelationship.productId | Sys_id du produit associé. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| productRelationship.relationshipType | Type de relation. Type de données : chaîne |
| Spécification du produit | Spécification du produit pour le produit. Type de données : objet |
| productSpecification.id | Version initiale ou ID externe de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : internal_version ou external_id |
| productSpecification.internalId | Version initiale du cahier des charges. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : initial_version |
| Spécification produit.versioninterne | Version de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : version |
| Spécificationproduit.version | Version externe de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : external_version |
| realizingResource (en cours de réalisation) | Ressource qui réalise le produit. La ressource de réalisation est un inventaire de produits enfants de cet inventaire de produits. Type de données : objet |
| realizingResource.id | Sys_id de la ressource de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingResource.type | Type de la ressource de réalisation. Valeur valide : enfant Type de données : chaîne |
| realizingService | Service qui réalise le produit. Le service de réalisation est un inventaire de produits enfants de cet inventaire de produits. Type de données : objet |
| realizingService.id | Sys_id du service de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingService.type | Type du service de réalisation. Valeur valide : enfant Type de données : chaîne |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.id | Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
| relatedParty.@referredType | Type de client. Valeurs possibles :
Type de données : chaîne |
| État | État actuel du produit. Type de données : chaîne |
Demande cURL
Cet exemple récupère tous les inventaires de produits.
curl --location --request GET "https://instance.service-now.com/api/sn_prd_invt/product" \
--user 'username':'password'
Corps de la réponse.
[
{
"id": "037fd87ec3603010abc8b5183c40ddf2",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Example Company",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "Routing and Configuration PI0000318",
"productSpecification": {
"id": "aec57e981bb420106ba59acf034bcb08",
"name": "Routing and Configuration",
"version": "",
"internalVersion": "1",
"internalId": "aec57e981bb420106ba59acf034bcb08"
},
"status": "Active",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering",
"version": "",
"internalVersion": "1",
"internalId": "69017a0f536520103b6bddeeff7b127d"
},
"productId": "ce0b52c7532520103b6bddeeff7b12f5",
"place": [
{
"id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c",
"name": "100 South Charles Street, Baltimore, MD"
}
],
"productCharacteristic": [],
"productRelationship": [],
"realizingService": [],
"realizingResource": [
{
"id": "9b2fa60b536520103b6bddeeff7b1233",
"name": "Route Target"
}
],
"productPrice": [],
"href": "/api/sn_prd_invt/product/037fd87ec3603010abc8b5183c40ddf2",
"billingAccount": "Not Specified."
}
]
API ouverte d’inventaire de produits : GET /sn_prd_invt/product/{id}
Récupère un enregistrement d’inventaire de produits spécifié.
Format d'URL
URL par défaut : /api/sn_prd_invt/product/{id}
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| id | Sys_id de l’inventaire des produits à récupérer. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| Nom | Description |
|---|---|
| customer | Filtrer les inventaires de produits par client. Seules les offres de produits avec un sys_id client ou un ID externe correspondant à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne Par défaut : Ne pas déposer ni client. |
| Champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Type de données : chaîne Par défaut : tous les champs renvoyés. |
| lieu | Filtrer les inventaires de produits par emplacement. Type de données : objet |
| place.id | ID Sys_id ou externe de l’emplacement associé à l’enregistrement d’inventaire des produits. Type de données : chaîne Table : Emplacement [cmn_location] Champ : sys_id ou sn_tmt_core_external_id |
| état | Filtrer les inventaires de produits par état. Seuls les inventaires de produits dont l’état correspond à la valeur de ce paramètre sont renvoyés dans la réponse. Type de données : chaîne Par défaut : ne pas filtrer par statut. |
| Nom | Description |
|---|---|
| Néant |
En-têtes
Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Néant |
| En-tête | Description |
|---|---|
| Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
Codes d'état
Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 200 | Demande traitée avec succès. |
| 400 |
Demande incorrecte. Peut être l’une des raisons suivantes :
|
| 404 | Enregistrement introuvable. L’enregistrement associé à l’ID est introuvable dans la table. |
Paramètres de corps de réponse (JSON)
| Nom | Description |
|---|---|
| billingAccount | Compte de facturation de l’enregistrement d’inventaire des produits. Type de données : chaîne |
| href | Lien relatif à l’enregistrement de l’inventaire des produits. Type de données : chaîne |
| id | Sys_id de l’inventaire des produits Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| nom | Nom de l’inventaire de produits. Type de données : chaîne |
| lieu | Emplacement du produit. Type de données : tableau |
| place.id | Emplacement sys_id ou ID externe. Type de données : chaîne Table : Emplacement [cmn_location] Champ : sys_id ou sn_tmt_core_external_id |
| place.name | Nom de l'emplacement. Type de données : chaîne Table : Emplacement [cmn_location] Champ : nom |
| productCaractéristique | Liste des caractéristiques du produit. Pour plus d’informations sur les caractéristiques du produit, reportez-vous à la section Create a product offering category. Type de données : tableau d’objets |
| productCharacteristic.name | Nom de la caractéristique. Type de données : chaîne |
| produitCaractéristique.valeur | Valeur de la caractéristique. Type de données : chaîne |
| productCharacteristic.valueType | Type de valeur caractéristique. Valeurs acceptées :
Type de données : chaîne |
| productId | Sys_id du modèle de produit pour l’inventaire des produits. Type de données : chaîne Table : Modèle de produit [cmdb_model] |
| productOffering | Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.id | Version initiale ou ID externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : initial_version ou external_id |
| offreproduit.identificateur interne | Version interne de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : internal_version |
| offreproduit.versioninterne | Version de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : version |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| offreproduit.version | Version externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : external_version |
| prix du produit | Renvoie un tableau vide. Type de données : tableau |
| Relation produit | Liste des produits connexes. Type de données : tableau d’objets |
| productRelationship.productId | Sys_id du produit associé. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| productRelationship.relationshipType | Type de relation. Type de données : chaîne |
| Spécification du produit | Spécification du produit pour le produit. Type de données : objet |
| productSpecification.id | Version initiale ou ID externe de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : internal_version ou external_id |
| productSpecification.internalId | Version initiale du cahier des charges. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : initial_version |
| Spécification produit.versioninterne | Version de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : version |
| Spécificationproduit.version | Version externe de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : external_version |
| realizingResource (en cours de réalisation) | Ressource qui réalise le produit. La ressource de réalisation est un inventaire de produits enfants de cet inventaire de produits. Type de données : objet |
| realizingResource.id | Sys_id de la ressource de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingResource.type | Type de la ressource de réalisation. Valeur valide : enfant Type de données : chaîne |
| realizingService | Service qui réalise le produit. Le service de réalisation est un inventaire de produits enfants de cet inventaire de produits. Type de données : objet |
| realizingService.id | Sys_id du service de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingService.type | Type du service de réalisation. Valeur valide : enfant Type de données : chaîne |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.id | Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
| relatedParty.type | Type de partie liée. La valeur est toujours Partie associée.Type de données : chaîne |
| relatedParty.@referredType | Type de client, tel qu’un client ou un contact de client. Type de données : chaîne |
| état | État actuel du produit. Type de données : chaîne |
Demande cURL
Cet exemple récupère un inventaire de produits spécifié.
curl -X GET 'https://instance.service-now.com/api/sn_prd_invt/product/037fd87ec3603010abc8b5183c40ddf2' \
--user 'username':'password'
Sortie :
{
"id": "037fd87ec3603010abc8b5183c40ddf2",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Example Company",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "Routing and Configuration PI0000318",
"productSpecification": {
"id": "aec57e981bb420106ba59acf034bcb08",
"name": "Routing and Configuration",
"version": "",
"internalVersion": "1",
"internalId": "aec57e981bb420106ba59acf034bcb08"
},
"status": "Active",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering",
"version": "",
"internalVersion": "1",
"internalId": "69017a0f536520103b6bddeeff7b127d"
},
"productId": "ce0b52c7532520103b6bddeeff7b12f5",
"place": [
{
"id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c",
"name": "100 South Charles Street, Baltimore, MD"
}
],
"productCharacteristic": [],
"productRelationship": [],
"realizingService": [],
"realizingResource": [
{
"id": "9b2fa60b536520103b6bddeeff7b1233",
"name": "Route Target"
}
],
"productPrice": [],
"href": "/api/sn_prd_invt/product/037fd87ec3603010abc8b5183c40ddf2",
"billingAccount": "Not Specified."
}
API ouverte d’inventaire des produits : GET /sn_prd_invt/productinventory
Récupère une liste de tous les inventaires de produits.
Format d'URL
URL par défaut : api/sn_prd_invt/productinventory
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| Néant |
| Nom | Description |
|---|---|
| customer | Filtrer les inventaires de produits par client. Seules les offres de produits avec un sys_id client ou un ID externe correspondant à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne Par défaut : ne pas filtrer par client. |
| Champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Type de données : chaîne Par défaut : tous les champs sont renvoyés. |
| limite | Nombre maximal d’enregistrements à renvoyer. Pour les demandes qui dépassent ce nombre d’enregistrements, utilisez le paramètre pour paginer la récupération de l’enregistrement offset . Type de données : nombre Par défaut : 20 Maximum : 100 |
| décalage | Index de départ sur lequel commencer à récupérer les enregistrements. Utilisez cette valeur pour paginer la récupération de l’enregistrement. Cette fonctionnalité permet de récupérer tous les enregistrements, quel que soit leur nombre, en petits blocs gérables. Type de données : nombre Par défaut : 0 |
| lieu | Filtrer les inventaires de produits par emplacement. Type de données : objet |
| place.id | ID Sys_id ou externe de l’emplacement associé à l’enregistrement d’inventaire des produits. Type de données : chaîne Table : Emplacement [cmn_location] Champ : sys_id ou sn_tmt_core_external_id |
| état | Filtrer les inventaires de produits par état. Seuls les inventaires de produits dont l’état correspond à la valeur de ce paramètre sont renvoyés dans la réponse. Type de données : chaîne Par défaut : ne filtrez pas par état d’inventaire. |
| Nom | Description |
|---|---|
| Néant |
En-têtes
Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Néant |
| En-tête | Description |
|---|---|
| Plage de contenu | Plage de contenu renvoyé dans un appel paginé. Par exemple, si |
| Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| un lien | Contient les liens suivants pour parcourir les résultats de la requête.
|
| Nombre X-Total | Pour les requêtes paginées, cet en-tête spécifie le nombre total d’enregistrements disponibles sur le serveur. |
Codes d'état
Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 200 | Demande traitée avec succès. Ressource complète renvoyée en réponse (aucune pagination). |
| 206 | Ressource partielle renvoyée en réponse (avec pagination). |
| 400 | Demande incorrecte. Raisons possibles :
|
| 404 | Enregistrement introuvable. Aucun enregistrement correspondant aux paramètres de requête n’a été trouvé dans la table. |
Paramètres de corps de réponse (JSON)
| Nom | Description |
|---|---|
| id | Sys_id de l’inventaire des produits. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| nom | Nom de l’inventaire de produits. Type de données : chaîne |
| lieu | Lieu associé au produit. Type de données : objet |
| place.id | Emplacement sys_id ou external_id de l’inventaire des produits. Table : Emplacement [cmn_location] Données : chaîne |
| place.name | Nom de l’emplacement associé à l’inventaire des produits. Table : Emplacement [cmn_location] Données : chaîne |
| productCaractéristique | Liste des caractéristiques du produit. Pour plus d’informations sur les caractéristiques du produit, reportez-vous à la section Create a product offering category. Type de données : tableau d’objets |
| productCharacteristic.name | Nom de la caractéristique. Type de données : chaîne |
| produitCaractéristique.valeur | Valeur de la caractéristique. Type de données : chaîne |
| productCharacteristic.valueType | Type de valeur caractéristique. Valeurs acceptées :
Type de données : chaîne |
| productOffering | Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.id | Sys_id de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| Relation produit | Liste des produits connexes. Type de données : tableau d’objets |
| productRelationship.productId | Sys_id du produit associé. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| productRelationship.relationshipType | Type de relation. Type de données : chaîne |
| Spécification du produit | Spécification du produit pour le produit. Type de données : objet |
| productSpecification.id | Sys_id de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] |
| realizingResource (en cours de réalisation) | Réaliser des ressources. Type de données : objet |
| realizingResource.id | Sys_id de la ressource de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingResource.type | Type de la ressource de réalisation. Type de données : chaîne |
| realizingService | Réaliser le service. Type de données : objet |
| realizingService.id | Sys_id du service de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingService.type | Type du service de réalisation. Type de données : chaîne |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.id | Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
| relatedParty.@referredType | Type de partie liée. La valeur est toujours Partie associée.Type de données : chaîne |
| relatedParty.type | Type de client. Valeurs possibles :
Type de données : chaîne |
| état | État actuel du produit. Type de données : chaîne |
Demande cURL
Cet exemple récupère tous les inventaires de produits.
curl "https://instance.servicenow.com/api/sn_prd_invt/productinventory" \
--request GET \
--user 'username':'password'
Corps de la réponse.
[
{
"id": "075072aec3a83010abc8b5183c40dd44",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "Firewall Administration PI0000300",
"productSpecification": {
"id": "31c5caff07266010a7955b7e0ad3006b",
"name": "Firewall Administration"
},
"status": "Active",
"productOffering": {
"id": "",
"name": ""
},
"place": {
"id": "920cf6ac73d423002728660c4cf6a799",
"name": "200 South James street,Atlanta, GA"
},
"productCharacteristic": [
{
"name": "Firewall Administration CPE Type",
"valueType": "Choice",
"value": "Physical"
},
{
"name": "Configuration and Policy backup",
"valueType": "Choice",
"value": ""
},
{
"name": "Firewall Administration CPE ID",
"valueType": "Single Line Text",
"value": "CPE123456789"
},
{
"name": "Remote CLI troubleshoot support",
"valueType": "Choice",
"value": ""
},
{
"name": "Firewall Administration CPE Model",
"valueType": "Choice",
"value": "9300 series"
}
],
"productRelationship": [],
"realizingService": [],
"realizingResource": [
{
"id": "3546463307666010a7955b7e0ad3005d",
"name": "Cisco Firewall Management system"
}
]
},
{
"id": "0303a8ea74418510f877ca57242ff96d",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "SD-WAN Edge Device PI0001114",
"productSpecification": {
"id": "39b627aa53702010cd6dddeeff7b1202",
"name": "SD-WAN Edge Device"
},
"status": "Installation Pending",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering"
},
"place": "",
"productCharacteristic": [],
"productRelationship": [],
"realizingService": [
{
"id": "bf65eadc1b7420106ba59acf034bcb57",
"name": "SD-WAN Routing"
},
{
"id": "16d79ec3532520103b6bddeeff7b12a6",
"name": "SD WAN Optimization Service"
},
{
"id": "16d79ec3532520103b6bddeeff7b12a6",
"name": "SD WAN Optimization Service"
},
{
"id": "bf65eadc1b7420106ba59acf034bcb57",
"name": "SD-WAN Routing"
},
{
"id": "bf65eadc1b7420106ba59acf034bcb57",
"name": "SD-WAN Routing"
},
{
"id": "bf65eadc1b7420106ba59acf034bcb57",
"name": "SD-WAN Routing"
}
],
"realizingResource": [
{
"id": "493fa60b536520103b6bddeeff7b12b6",
"name": "Customer Premise SD-WAN Router"
}
]
}
]
API ouverte d’inventaire de produits : GET /sn_prd_invt/productinventory/{inventoryId}
Récupère un inventaire de produits.
Format d'URL
URL par défaut : /api/sn_prd_invt/productinventory/{inventoryId}
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| ID d’inventaire | Sys_id de l’inventaire des produits à récupérer. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| Nom | Description |
|---|---|
| customer | Filtrer les inventaires de produits par client. Seules les offres de produits avec un sys_id client ou un ID externe correspondant à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne |
| Champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Type de données : chaîne Par défaut : tous les champs renvoyés. |
| lieu | Filtrer les inventaires de produits par emplacement. Type de données : objet |
| place.id | ID Sys_id ou externe de l’emplacement associé à l’enregistrement d’inventaire des produits. Type de données : chaîne Table : Emplacement [cmn_location] Champ : sys_id ou sn_tmt_core_external_id |
| état | Filtrer les inventaires de produits par état. Seuls les inventaires de produits dont l’état correspond à la valeur de ce paramètre sont renvoyés dans la réponse. Type de données : chaîne |
| Nom | Description |
|---|---|
| Néant |
En-têtes
Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Néant |
| En-tête | Description |
|---|---|
| Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
Codes d'état
Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 200 | Demande traitée avec succès. |
| 400 | Demande incorrecte. Peut être l’une des raisons suivantes :
|
| 404 | Enregistrement introuvable. L’enregistrement associé à l’ID est introuvable dans la table. |
Paramètres de corps de réponse (JSON)
| Nom | Description |
|---|---|
| id | Sys_id de l’inventaire des produits Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| nom | Nom de l’inventaire de produits. Type de données : chaîne |
| lieu | Lieu associé au produit. Type de données : objet |
| place.id | Emplacement sys_id ou external_id de l’inventaire des produits. Table : Emplacement [cmn_location] Données : chaîne |
| place.name | Nom de l’emplacement associé à l’inventaire des produits. Table : Emplacement [cmn_location] Données : chaîne |
| productCaractéristique | Liste des caractéristiques du produit. Pour plus d’informations sur les caractéristiques du produit, reportez-vous à la section Create a product offering category. Type de données : tableau d’objets |
| productCharacteristic.name | Nom de la caractéristique. Type de données : chaîne |
| produitCaractéristique.valeur | Valeur de la caractéristique. Type de données : chaîne |
| productCharacteristic.valueType | Type de valeur caractéristique. Valeurs acceptées :
Type de données : chaîne |
| productOffering | Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.id | Sys_id de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| Relation produit | Liste des produits connexes. Type de données : tableau d’objets |
| productRelationship.productId | Sys_id du produit associé. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| productRelationship.relationshipType | Type de relation. Type de données : chaîne |
| Spécification du produit | Spécification du produit pour le produit. Type de données : objet |
| productSpecification.id | Sys_id de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] |
| realizingResource (en cours de réalisation) | Réaliser des ressources. Type de données : objet |
| realizingResource.id | Sys_id de la ressource de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingResource.type | Type de la ressource de réalisation. Type de données : chaîne |
| realizingService | Réaliser le service. Type de données : objet |
| realizingService.id | Sys_id du service de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingService.type | Type du service de réalisation. Type de données : chaîne |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.id | Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
| relatedParty.@referredType | Type de partie liée. La valeur est toujours Partie associée.Type de données : chaîne |
| relatedParty.type | Type de client. Valeurs possibles :
Type de données : chaîne |
| état | État actuel du produit. Type de données : chaîne |
Demande cURL
Cet exemple récupère un inventaire de produits pour un package de services SD-WAN.
curl --location --request GET 'https:// instance.servicenow.com/api/sn_prd_invt/productinventory/074450fc74918d10f877ca57242ff9e3' \
--user 'username':'password'
Sortie :
{
"id": "074450fc74918d10f877ca57242ff9e3",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "SD-WAN Service Package PI0001576",
"productSpecification": {
"id": "cfe5ef6a53702010cd6dddeeff7b12f6",
"name": "SD-WAN Service Package"
},
"status": "Installation Pending",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering"
},
"place": "",
"productCharacteristic": [],
"productRelationship": [
{
"id": "a74490fc74918d10f877ca57242ff942",
"name": "SD-WAN Edge Device PI0001582",
"relationshipType": "Bundles"
},
{
"id": "b85414fc74918d10f877ca57242ff90e",
"name": "SD-WAN Controller PI0001602",
"relationshipType": "Bundles"
},
{
"id": "d74490fc74918d10f877ca57242ff907",
"name": "SD-WAN Security PI0001577",
"relationshipType": "Bundles"
}
],
"realizingService": [],
"realizingResource": []
}
API ouverte de l’inventaire des produits : PATCH /sn_prd_invt/order/product/{id}
Met à jour un enregistrement d’inventaire de produits spécifié.
Format d'URL
URL par défaut : /api/sn_prd_invt/order/product/{id}
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| id | Sys_id de l’inventaire des produits à mettre à jour. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| Nom | Description |
|---|---|
| Néant |
| Nom | Description |
|---|---|
| ensemble | Marqueur indiquant si l’enregistrement d’inventaire des produits fait partie d’un produit groupé. Valeurs valides :
Type de données : booléennes |
| nom | Nom de l’inventaire de produits. Type de données : chaîne |
| lieu | Emplacement du produit. Type de données : tableau |
| place.id | Emplacement sys_id ou ID externe. Type de données : chaîne Table : Emplacement [cmn_location] Champ : sys_id ou sn_tmt_core_external_id |
| place.name | Nom de l'emplacement. Type de données : chaîne Table : Emplacement [cmn_location] Champ : nom |
| productOffering | Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.@referredType | Cette valeur est toujours ProductOffering.Type de données : chaîne |
| productOffering.id | Version initiale ou ID externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : initial_version ou external_id |
| offreproduit.identificateur interne | Version interne de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : internal_version |
| offreproduit.versioninterne | Version de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : version |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : nom |
| offreproduit.statut | État de l’offre de produits. Valeurs possibles :
Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : état |
| offreproduit.version | Version externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : external_version |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.@referredType | Type de partie liée. Valeurs possibles :
Type de données : chaîne |
| relatedParty.@type | Cette valeur est toujours RelatedParty.Type de données : chaîne |
| relatedParty.id | Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
| relatedParty.name | Nom du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
En-têtes
Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| Type de contenu | Format des données du corps de la demande. Prend uniquement en charge application/json. |
| En-tête | Description |
|---|---|
| Néant |
Codes d'état
Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 200 | Réussi. La demande a été traitée avec succès. |
| 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. |
| 404 | Introuvable. L’élément demandé est introuvable. |
Paramètres de corps de réponse (JSON)
| Nom | Description |
|---|---|
| ensemble | Marqueur indiquant si l’enregistrement d’inventaire des produits fait partie d’un produit groupé. Valeurs valides :
Type de données : booléennes |
| nom | Nom de l’inventaire de produits. Type de données : chaîne |
| lieu | Emplacement du produit. Type de données : tableau |
| place.id | Emplacement sys_id ou ID externe. Type de données : chaîne Table : Emplacement [cmn_location] Champ : sys_id ou sn_tmt_core_external_id |
| place.name | Nom de l'emplacement. Type de données : chaîne Table : Emplacement [cmn_location] Champ : nom |
| productOffering | Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.@referredType | Cette valeur est toujours ProductOffering.Type de données : chaîne |
| productOffering.id | Version initiale ou ID externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : initial_version ou external_id |
| offreproduit.identificateur interne | Version interne de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : internal_version |
| offreproduit.versioninterne | Version de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : version |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : nom |
| offreproduit.statut | État de l’offre de produits. Valeurs possibles :
Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : état |
| offreproduit.version | Version externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : external_version |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.@referredType | Type de partie liée. Valeurs possibles :
Type de données : chaîne |
| relatedParty.@type | Cette valeur est toujours RelatedParty.Type de données : chaîne |
| relatedParty.id | Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
| relatedParty.name | Nom du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
Demande cURL
Cet exemple met à jour un enregistrement d’inventaire de produits.
curl "https://instance.service-now.com/api/sn_prd_invt/product/036e506510322250f8777d910acbd77f" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"name\": \"Internet Plan\",
\"productOffering\": {
\"@referredType\": \"ProductOffering\",
\"name\": \"Premium SD-WAN Offering\",
\"id\": \"0361dd9fd0a63110f8770dbf976be16f\"
},
\"relatedParty\": [
{
\"@referredType\": \"CustomerContact\",
\"@type\": \"RelatedParty\",
\"name\": \"Sally Thomas\",
\"id\": \"f3af54c413651200042ab3173244b053\"
},
{
\"@referredType\": \"Customer\",
\"@type\": \"RelatedParty\",
\"name\": \"Funco Intl\",
\"id\": \"ffc68911c35420105252716b7d40dd55\"
}
],
\"bundle\": false,
\"place\": [
{
\"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",
\"name\": \"100 South Charles Street, Baltimore, MD\"
}
]
}" \
--user 'username':'password'
Corps de la réponse.
{
"name": "Internet Plan",
"productOffering": {
"@referredType": "ProductOffering",
"name": "Premium SD-WAN Offering",
"id": "0361dd9fd0a63110f8770dbf976be16f",
"internalVersion": "1",
"version": "",
"status": "published",
"internalId": "0361dd9fd0a63110f8770dbf976be16f"
},
"relatedParty": [
{
"@referredType": "CustomerContact",
"@type": "RelatedParty",
"name": "Sally Thomas",
"id": "f3af54c413651200042ab3173244b053"
},
{
"@referredType": "Customer",
"@type": "RelatedParty",
"name": "Funco Intl",
"id": "ffc68911c35420105252716b7d40dd55"
}
],
"bundle": false,
"place": [
{
"id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c",
"name": "100 South Charles Street, Baltimore, MD"
}
],
"productPrice": [],
"id": "036e506510322250f8777d910acbd77f",
"href": "/api/sn_prd_invt/product/036e506510322250f8777d910acbd77f"
}
Inventaire des produits Ouvrir l’API : POST /sn_prd_invt/product
Crée un enregistrement d’inventaire de produits.
Format d'URL
URL par défaut : /api/sn_prd_invt/product
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| Néant |
| Nom | Description |
|---|---|
| Néant |
| Nom | Description |
|---|---|
| ensemble | Marqueur indiquant si l’enregistrement d’inventaire des produits fait partie d’un produit groupé. Valeurs valides :
Type de données : booléennes Valeur par défaut : false |
| isBundle | Marqueur indiquant si l’enregistrement d’inventaire des produits fait partie d’un produit groupé. Valeurs valides :
Type de données : booléennes Valeur par défaut : false |
| nom | Requis. Nom de l’inventaire de produits. Type de données : chaîne |
| pid | Identificateur unique pour l’inventaire des produits du système externe. Type de données : chaîne Valeur par défaut : chaîne vide |
| productCaractéristique | Liste des caractéristiques du produit. Pour plus d’informations sur les caractéristiques du produit, reportez-vous à la section Create a product offering category. Type de données : tableau d’objets |
| productCharacteristic.name | Nom de la caractéristique. Type de données : chaîne Valeur par défaut : chaîne vide |
| produitCaractéristique.valeur | Valeur de la caractéristique. Type de données : chaîne Valeur par défaut : chaîne vide |
| productCharacteristic.valueType | Type de valeur caractéristique. Valeurs acceptées :
Type de données : chaîne |
| productOffering | Requis. Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.id | Requis. Initial_version ou external_id de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| offreproduit.versioninterne | Version de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : version |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Valeur par défaut : chaîne vide Table : Offre de produits [sn_prd_pm_product_offering] |
| offreproduit.version | Version externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : external_version |
| Relation produit | Liste des produits connexes. Type de données : tableau d’objets |
| productRelationship.productId | Requis si le productRelationship paramètre est utilisé. Sys_id du produit associé. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| productRelationship.relationshipType | Type de relation. La seule valeur valide est enfant. Type de données : chaîne Valeur par défaut : chaîne vide |
| Spécification du produit | Requis. Spécification du produit pour le produit. Type de données : objet |
| productSpecification.id | Requis. Initial_version ou external_id de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] |
| Spécification produit.versioninterne | Version de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : version |
| Spécificationproduit.version | Version externe de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : external_version |
| realizingResource (en cours de réalisation) | Ressource qui réalise le produit. La ressource de réalisation est un inventaire de produits enfants de cet inventaire de produits. Type de données : objet |
| realizingResource.id | Requis si le realizingResource paramètre est utilisé. Sys_id de la ressource de réalisation. Type de données : chaîne |
| realizingResource.type | Type de la ressource de réalisation. Valeur valide : enfant Type de données : chaîne |
| realizingService | Service qui réalise le produit. Le service de réalisation est un inventaire de produits enfants de cet inventaire de produits. Type de données : objet |
| realizingService.id | Requis si le realizingService paramètre est utilisé. Sys_id du service de réalisation. Type de données : chaîne |
| realizingService.type | Type du service de réalisation. Valeur valide : enfant Type de données : chaîne |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.@referredType | Type de client. Valeurs possibles :
Type de données : chaîne Valeur par défaut : chaîne vide |
| relatedParty.id | Requis si le relatedParty paramètre est utilisé. Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
| État | État actuel du produit. Valeurs possibles :
Type de données : chaîne Par défaut : installation_pending |
En-têtes
Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| Type de contenu | Format des données du corps de la demande. Prend uniquement en charge application/json. |
| En-tête | Description |
|---|---|
| Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
Codes d'état
Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 201 | Demande traitée avec succès. |
| 400 | Demande incorrecte. Peut être l’une des raisons suivantes :
|
Paramètres de corps de réponse (JSON)
| Nom | Description |
|---|---|
| ensemble | Marqueur indiquant si l’enregistrement d’inventaire des produits fait partie d’un produit groupé. Valeurs valides :
Type de données : booléennes |
| href | Lien relatif à l’enregistrement de l’inventaire des produits. Type de données : chaîne |
| id | Sys_id de l’inventaire des produits. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| isBundle | Marqueur indiquant si l’enregistrement d’inventaire des produits fait partie d’un produit groupé. Valeurs valides :
Type de données : booléennes |
| nom | Nom de l’inventaire de produits. Type de données : chaîne |
| pid | Identificateur unique pour l’inventaire des produits du système externe. Type de données : chaîne |
| productCaractéristique | Liste des caractéristiques du produit. Type de données : tableau d’objets |
| productCharacteristic.name | Nom de la caractéristique. Type de données : chaîne |
| produitCaractéristique.valeur | Valeur de la caractéristique. Type de données : chaîne |
| productOffering | Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.id | Version initiale ou ID externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : initial_version ou external_id |
| offreproduit.identificateur interne | Version interne de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : internal_version |
| offreproduit.versioninterne | Version de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : version |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| offreproduit.version | Version externe de l’offre de produit. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] Champ : external_version |
| prix du produit | Renvoie un tableau vide. Type de données : tableau |
| Relation produit | Liste des produits connexes. Type de données : tableau d’objets |
| productRelationship.productId | Sys_id du produit associé. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| productRelationship.relationshipType | Type de relation. Type de données : chaîne |
| Spécification du produit | Spécification du produit pour le produit. Type de données : objet |
| productSpecification.id | Version initiale ou ID externe de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : internal_version ou external_id |
| productSpecification.internalId | Version initiale du cahier des charges. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : initial_version |
| Spécification produit.versioninterne | Version de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : version |
| Spécificationproduit.version | Version externe de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] Champ : external_version |
| realizingResource (en cours de réalisation) | Ressource qui réalise le produit. La ressource de réalisation est un inventaire de produits enfants de cet inventaire de produits. Type de données : objet |
| realizingResource.id | Sys_id de la ressource de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingResource.type | Type de la ressource de réalisation. Valeur valide : enfant Type de données : chaîne |
| realizingService | Service qui réalise le produit. Le service de réalisation est un inventaire de produits enfants de cet inventaire de produits. Type de données : objet |
| realizingService.id | Sys_id du service de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingService.type | Type du service de réalisation. Valeur valide : enfant Type de données : chaîne |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.@referredType | Type de partie liée. La valeur est toujours Partie associée.Type de données : chaîne |
| relatedParty.id | Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table :Compte [customer_account], Contact [customer_contact] ou Consommateur [csm_consumer] |
| relatedParty.type | Type de client. Valeurs possibles :
Type de données : chaîne |
| état | État actuel du produit. Type de données : chaîne |
Demande cURL
Cet exemple crée un inventaire de produits pour une solution de voix sur IP pour un utilisateur.
curl -X POST "https://instance.service-now.com/api/sn_prd_invt/product" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password" \
--data "[
{
"pid": "PO-456",
"description": "inventory description",
"isBundle": false,
"name": "Voice Over IP Basic instance for Jean",
"productOffering": {
"@referredType": "ProductOffering",
"name": "Premium SD-WAN Offering",
"id": "69017a0f536520103b6bddeeff7b127d"
},
"productCharacteristic": [],
"productRelationship": [
{
"productId": "fa6d13f45b5620102dff5e92dc81c77f",
"relationshipType": "child"
}
],
"realizingService": {
"id": "fe6d13f45b5620102dff5e92dc81c786",
"relationshipType": "child"
},
"realizingResource": {
"id": "326d13f45b5620102dff5e92dc81c78c",
"relationshipType": "child"
},
"relatedParty": [
{
"@referredType": "CustomerContact",
"@type": "RelatedParty",
"name": "Sally Thomas",
"id": "eaf68911c35420105252716b7d40ddde"
},
{
"@referredType": "Customer",
"@type": "RelatedParty",
"name": "Funco Intl",
"id": "ffc68911c35420105252716b7d40dd55"
}
],
"productSpecification": {
"@referredType": "ProductSpecification",
"@type": null,
"name": null,
"id": "3ee1fdb1c3331010d216b5183c40dd81",
"internalVersion": "1"
},
"bundle": false
}
]"
Corps de la réponse.
{
"pid": "PO-456",
"description": "inventory description",
"isBundle": false,
"name": "Voice Over IP Basic instance for Jean",
"productOffering": {
"@referredType": "ProductOffering",
"name": "Premium SD-WAN Offering",
"id": "69017a0f536520103b6bddeeff7b127d",
"internalVersion": "1",
"version": null,
"status": "published",
"internalId": "69017a0f536520103b6bddeeff7b127d"
},
"productCharacteristic": [],
"productRelationship": [
{
"productId": "fa6d13f45b5620102dff5e92dc81c77f",
"relationshipType": "child"
}
],
"realizingService": {
"id": "fe6d13f45b5620102dff5e92dc81c786",
"relationshipType": "child"
},
"realizingResource": {
"id": "326d13f45b5620102dff5e92dc81c78c",
"relationshipType": "child"
},
"relatedParty": [
{
"@referredType": "CustomerContact",
"@type": "RelatedParty",
"name": "Sally Thomas",
"id": "eaf68911c35420105252716b7d40ddde"
},
{
"@referredType": "Customer",
"@type": "RelatedParty",
"name": "Example Company",
"id": "ffc68911c35420105252716b7d40dd55"
}
],
"productSpecification": {
"@referredType": "ProductSpecification",
"@type": null,
"name": null,
"id": "3ee1fdb1c3331010d216b5183c40dd81",
"internalVersion": "1",
"version": null,
"status": "published",
"internalId": "3ee1fdb1c3331010d216b5183c40dd81"
},
"bundle": false,
"productPrice": [],
"id": "25b07475471789108761b955d36d439d",
"href": "/api/sn_prd_invt/product/25b07475471789108761b955d36d439d"
}
API ouverte d’inventaire de produits : POST /sn_prd_invt/productinventory
Crée un inventaire des produits.
Format d'URL
URL par défaut : /api/sn_prd_invt/productinventory
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| Néant |
| Nom | Description |
|---|---|
| Néant |
| Nom | Description |
|---|---|
| isBundle | Marqueur indiquant si l’enregistrement d’inventaire des produits fait partie d’un produit groupé. Valeurs valides :
Type de données : booléennes Valeur par défaut : false |
| nom | Requis. Nom de l’inventaire de produits. Type de données : chaîne |
| pid | Identificateur unique pour l’inventaire des produits du système externe. Type de données : chaîne Valeur par défaut : chaîne vide |
| productCaractéristique | Liste des caractéristiques du produit. Pour plus d’informations sur les caractéristiques du produit, reportez-vous à la section Create a product offering category. Type de données : tableau d’objets |
| productCharacteristic.name | Nom de la caractéristique. Type de données : chaîne Valeur par défaut : chaîne vide |
| produitCaractéristique.valeur | Valeur de la caractéristique. Type de données : chaîne Valeur par défaut : chaîne vide |
| productCharacteristic.valueType | Type de valeur caractéristique. Valeurs acceptées :
Type de données : chaîne |
| productOffering | Requis. Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.id | Requis. Sys_id de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Valeur par défaut : chaîne vide Table : Offre de produits [sn_prd_pm_product_offering] |
| Relation produit | Liste des produits connexes. Type de données : tableau d’objets |
| productRelationship.productId | Requis si le productRelationship paramètre est utilisé. Sys_id du produit associé. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| productRelationship.relationshipType | Type de relation. La seule valeur valide est enfant. Type de données : chaîne Valeur par défaut : chaîne vide |
| Spécification du produit | Requis. Spécification du produit pour le produit. Type de données : objet |
| productSpecification.id | Requis. Sys_id de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] |
| realizingResource (en cours de réalisation) | Réaliser des ressources. Type de données : objet |
| realizingResource.id | Requis si le realizingResource paramètre est utilisé. Sys_id de la ressource de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingResource.type | Type de la ressource de réalisation. La seule valeur valide est enfant. Type de données : chaîne Valeur par défaut : chaîne vide |
| realizingService | Réaliser le service. Type de données : objet |
| realizingService.id | Requis si le realizingService paramètre est utilisé. Sys_id du service de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingService.type | Type du service de réalisation. La seule valeur valide est enfant. Type de données : chaîne Valeur par défaut : chaîne vide |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.@referredType | Type de client. Valeurs possibles :
Type de données : chaîne Valeur par défaut : chaîne vide |
| relatedParty.id | Requis si le relatedParty paramètre est utilisé. Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_Consumer] |
| État | État actuel du produit. Valeurs possibles :
Type de données : chaîne Par défaut : installation_pending |
En-têtes
Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| Type de contenu | Format des données du corps de la demande. Prend uniquement en charge application/json. |
| En-tête | Description |
|---|---|
| Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
Codes d'état
Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 201 | Demande traitée avec succès. |
| 400 | Demande incorrecte. Peut être l’une des raisons suivantes :
|
Paramètres de corps de réponse (JSON)
| Nom | Description |
|---|---|
| id | Sys_id de l’inventaire des produits. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| isBundle | Marqueur indiquant si l’enregistrement d’inventaire des produits fait partie d’un produit groupé. Valeurs valides :
Type de données : booléennes |
| nom | Nom de l’inventaire de produits. Type de données : chaîne |
| pid | Identificateur unique pour l’inventaire des produits du système externe. Type de données : chaîne |
| productCaractéristique | Liste des caractéristiques du produit. Type de données : tableau d’objets |
| productCharacteristic.name | Nom de la caractéristique. Type de données : chaîne |
| produitCaractéristique.valeur | Valeur de la caractéristique. Type de données : chaîne |
| productOffering | Offre de produits à laquelle l’inventaire des produits est associé. Type de données : objet |
| productOffering.id | Sys_id de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| productOffering.name | Nom de l’offre de produits. Type de données : chaîne Table : Offre de produits [sn_prd_pm_product_offering] |
| Relation produit | Liste des produits connexes. Type de données : tableau d’objets |
| productRelationship.productId | Sys_id du produit associé. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| productRelationship.relationshipType | Type de relation. Type de données : chaîne |
| Spécification du produit | Spécification du produit pour le produit. Type de données : objet |
| productSpecification.id | Sys_id de la spécification du produit. Type de données : chaîne Tableau : Spécification de produit [sn_prd_pm_product_specification] |
| realizingResource (en cours de réalisation) | Réaliser des ressources. Type de données : objet |
| realizingResource.id | Sys_id de la ressource de réalisation Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingResource.type | Type de la ressource de réalisation. Type de données : chaîne |
| realizingService | Réaliser le service. Type de données : objet |
| realizingService.id | Sys_id du service de réalisation. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory] |
| realizingService.type | Type du service de réalisation. Type de données : chaîne |
| Fête connexe | Liste des parties associées au ticket. Type de données : tableau d’objets |
| relatedParty.id | Sys_id du compte ou du contact client associé au ticket. Type de données : chaîne Table : compte [customer_account], contact [customer_contact] ou consommateur [csm_consumer] |
| relatedParty.@referredType | Type de client. Valeurs possibles :
Type de données : chaîne |
| État | État actuel du produit. Type de données : chaîne |
Demande cURL
Cet exemple crée un inventaire de produits pour une solution de voix sur IP pour un utilisateur.
curl --location --request POST "https://instance.servicenow.com/api/sn_prd_invt/productinventory" \
--header "Content-Type: application/json" \
--data-raw '[
{
"pid": "demoInventory",
"description": "inventory description",
"isBundle": false,
"name": "Voice Over IP Basic instance for Jean",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering",
"@referredType": "ProductOffering"
},
"productCharacteristic": [
{
"name": "CPE Type",
"valueType": "choice",
"value": "Virtual"
},
{
"name":"Routing",
"valueType": "choice",
"value": "Premium"
}
],
"productRelationship": [
{
"productId": "7e6d13f45b5620102dff5e92dc81c787",
"relationshipType": "child"
}
],
"relatedParty": [
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"role": "User",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
},
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
}
],
"productSpecification": {
"id": "cfe5ef6a53702010cd6dddeeff7b12f6",
"@referredType": "ProductSpecification",
"version": "1"
}
}
]'
--user 'username':'password'
Corps de la réponse.
{
"pid": "demoInventory",
"description": "inventory description",
"isBundle": false,
"name": "Voice Over IP Basic instance for Jean",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering",
"@referredType": "ProductOffering"
},
"productCharacteristic": [
{
"name": "CPE Type",
"valueType": "choice",
"value": "Virtual"
},
{
"name": "Routing",
"valueType": "choice",
"value": "Premium"
}
],
"productRelationship": [
{
"productId": "7e6d13f45b5620102dff5e92dc81c787",
"relationshipType": "child"
}
],
"relatedParty": [
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"role": "User",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
},
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
}
],
"productSpecification": {
"id": "cfe5ef6a53702010cd6dddeeff7b12f6",
"@referredType": "ProductSpecification",
"version": "1"
},
"id": "3ac715c6745d8150f877ca57242ff97a"
}