# sendSupplierEmail
source: https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/sendsupplieremail/index.md

Send a supplier notification of purchase or a remittance email for an approved purchase request if a supplier is configured to receive email notifications.
Note: The sendSupplierEmail API call is not applicable to ICMP.

The supplier email includes Payment Advice Details (PAD) ^[1](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/sendsupplieremail/index.md#fn:1)^ attachment if a purchase request (only for non [Straight Through Processing (STP)](https://developer.mastercard.com/product/straight-through-processing-stp/) suppliers) has invoice addenda data.{#fnref:1}

### Prerequisites {#prerequisites}

* The purchase request should have a default supplier email address.
* The supplier should be active.

#### Request Headers {#request-headers}

|    Key name     |                   Value                    |                                                                                                            Description for ICCP                                                                                                            |
|-----------------|--------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Idempotency-Key | Any random UUID set in HTTP Request Header | 1. The header key Idempotency-Key is optional. 2. If the header key Idempotency-Key is added then it should be non-null and non-empty. 3. Max length of key is 80 chars. 4. It is recommended that the key is UUID and generated randomly. |

## Parameter {#parameter}

ID of an approved purchase request.

### Sample request {#sample-request}

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ser="http://mastercard.com/sd/pc2/service">
	<soapenv:Header/>
	<soapenv:Body>
		<ser:sendSupplierEmailRequest>
			<ser:purchaseRequestId>900497</ser:purchaseRequestId>
		</ser:sendSupplierEmailRequest>
	</soapenv:Body>
</soapenv:Envelope>
```

## Response {#response}

You receive a success message.

### Sample response {#sample-response}

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
	<soapenv:Body>
		<ns2:sendSupplierEmailResponse xmlns="http://mastercard.com/sd/pc/service"
			xmlns:ns2="http://mastercard.com/sd/pc2/service">
			<ns2:response>Supplier email successfully created.</ns2:response>
			<ns2:errorMessage xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
		</ns2:sendSupplierEmailResponse>
	</soapenv:Body>
</soapenv:Envelope>
```

*** ** * ** ***

1. Payment Advice Details (PAD) is a report in Comma-Separated Value (CSV) format that can be used by suppliers to match Virtual Card Numbers received to their invoices. The report includes **InvoiceNumber** and, if available, **TotalAmount** and **CurrencyCode** for the invoiced amount, **InvoiceDate** and **PONumber** . [↩︎](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/sendsupplieremail/index.md#fnref:1)

   {#fn:1}
{#fn:1}