API d'approvisionnement (/quote_requests)
Utilisez l'API Coupa Sourcing pour créer de nouveaux événements RFx, voir les réponses des fournisseurs et attribuer des fournisseurs au niveau de la ligne.
Aperçu
Utiliser l'API d'approvisionnement pour :
- Créez des événements de type RFP, RFI ou RFQ.
- Extraire les réponses du fournisseur à l'événement.
- Attribuer des événements aux fournisseurs au niveau de la ligne.
Pour le back-end Coupa, un événement de sourcing est connu sous le nom de demande de devis.
Points de terminaison
Les points de terminaison suivants sont disponibles pour l'API de sourcing.
Ressource | Chemin d'accès | Description |
---|---|---|
Événements de sourcing |
|
Point de terminaison pour la création de nouveaux événements de sourcing et la gestion des événements existants |
Réponses des fournisseurs |
|
Point de terminaison pour travailler avec les réponses des fournisseurs |
Sourcing suppliers |
|
Point de terminaison pour obtenir des informations sur les fournisseurs lors d'un événement d'approvisionnement |
Exemples d'appels
Créer un nouvel événement de sourcing
POST /api/quote_requests/
Pour créer un nouvel événement, vous pouvez envoyer un MESSAGE de base. Incluez l' <event-type>
élément ou Coupa aura par défaut une RFI.
Charge utile
<?xml version="1.0" encoding="UTF-8" ?>
<quote-request>
<event-type type="symbol">Demande de devis</event-type>
</quote-request>
201 Réponse positive
Coupa renvoie l'événement de sourcing nouvellement créé, avec un élément unique <id>
.
<?xml version="1.0" encoding="UTF-8"?>
<quote-request>
<id type="integer">1434</id>
<created-at type="dateTime">11/04/2018T10:37:25-07:00</created-at>
<updated-at type="dateTime">11/04/2018T10:46:58-07:00</updated-at>
<description nil="true" />
<start-time type="dateTime">2018-04-11T17:00:00-07:00:00</start-time>
<start-on-submit type="boolean">true</start-on-submit>
<event-type type="symbol">rfi</event-type>
<end-time type="dateTime">25/04/2018T17:00:00-07:00</end-time>
<state>brouillon</state>
<comments nil="true" />
<allow-multiple-response type="boolean">true</allow-multiple-response>
<sealed-bids type="boolean">true</sealed-bids>
<allow-award-individual-line-items type="boolean">faux</allow-award-individual-line-items>
<automatic-bid-unsealing type="boolean">true</automatic-bid-unsealing>
<timezone>États-Unis/Pacifique</timezone>
<currency>...</currency>
<lots type="array" />
<lines type="array" />
<quote-suppliers type="array" />
<attachments type="array" />
<forms type="array" />
<quote-request-attachments type="array" />
<tags type="array" />
<business-partners type="array" />
</business-partners>
<created-by>...</created-by>
<updated-by>...</updated-by>
<custom-fields />
</quote-request>
Voir toutes les réponses du fournisseur pour un événement spécifique
GET /api/quote_requests/{event_id}/quote_responses
200 OK réponse
<?xml version="1.0" encoding="UTF-8"?>
<quote-responses type="array">
<quote-response>
<id type="integer">1080</id>
<created-at type="dateTime">2018-04-10T05:51:28-07:00</created-at>
<updated-at type="dateTime">2018-04-10T05:51:34-07:00</updated-at>
<quote-request-id type="integer">1429</quote-request-id>
<submitted-at type="dateTime">2018-04-10T05:51:34-07:00</submitted-at>
<state>soumis</state>
<position type="integer">2</position>
<comments nil="true" />
<lines type="array">
<line>
<id type="integer">7447</id>
<created-at type="dateTime">2018-04-10T05:51:28-07:00</created-at>
<updated-at type="dateTime">2018-04-10T05:51:33-07:00</updated-at>
<price-amount type="decimal">200,0</price-amount>
<quantity type="decimal">1,0</quantity>
<reporting-price-amount type="decimal">200,0</reporting-price-amount>
<price-currency>...</price-currency>
<quote-request-line-id type="integer">5834</quote-request-line-id>
<lot-id type="integer">0</lot-id>
</line>
</lines>
<quote-supplier>
<id type="integer">1714</id>
<created-at type="dateTime">2018-04-10T05:50:21-07:00</created-at>
<updated-at type="dateTime">2018-04-10T05:51:34-07:00</updated-at>
<name>bnew</name>
<display-name>bnew</display-name>
<email>irairaira666555@gmail.com</email>
<contact-name />
<supplier nil="true" />
<created-by>...</created-by>
<updated-by>...</updated-by>
</quote-supplier>
</quote-response>
</quote-responses>
Attribuer un événement à un fournisseur
POST /api/quote_responses/{response_id}/award
Une fois que vous avez obtenu la réponse <id>
, vous pouvez l'utiliser pour attribuer la réponse.
Charge utile à attribuer
<?xml version="1.0" encoding="UTF-8"?>
<root>
<quote_response_line_ids>7447</quote_response_line_ids>
</root>
si vous ne spécifiez aucun ID de ligne de réponse de devis (7447 comme dans l'exemple ci-dessus), vous pouvez attribuer toutes les lignes à la fois.
200 OK Réponse
Coupa renvoie un 200 OK sans corps.