« Back to SOAP operation list

addUpsellings2Offer

This operation adds upsellings to an existing active offer identified by an offerCode. This endpoint has only one required field which is productId. The rest of the fields are auto-calculated by the endpoint logic and are not mandatory in the request.

Request

WSDL Production URL

https://api.infojobs.[net|it]/soap/WSOfferV4Service?wsdl

WSDL Testing URL

https://api.infojobssbx.[net|it]/soap/WSOfferV4Service?wsdl

Security

  • User Role: ROLE_EMPLOYER

Parameters

Name Description

offerCode

String

Required

The string code that identifies the job offer.

upsellings

List of upselling entity

Required

The id of the upselling type.
Fields related to the upselling entity
Name Description

productId

Integer

Required

The id of the upselling type.

order

Integer

This field must not be informed UNLESS the "productId" corresponds with the "Additional Province" upselling (id 77), in which case this field will contain the province ID.

In the case where you want to add more than one additional province, you will have to add one upselling entity per additional province, each one with the "productId" set to 77 and the "order" field set to the corresponding additional province ID.

In order to obtain all valid province IDs for a given countryId you can use the operation findByListNameAndParentId providing the publicNameKey of the appropriate list.

In the request you should use PROVINCES as the publicNameKey and the value of the countryId as the parentId.

Example values: 9 (Barcelona)

In this example the identifier 9 is obtained using the findByListNameAndParentId operation with publicNameKey: PROVINCES and the parentId:17 obtained in the previous example.

Maximum number of additional provinces that can be added is 4.

Response

Response entity

The response will include a summary of the offer and a list of all its upsellings.

Name Description

jobTitle

The title of the job offer

jobReference

Used by the company for classification purposes.

jobIndustryId

The job industry identifier.

offerCode

The job offer identifier

provinceId

The identifier of the job offer province

upsellingsDTO

Upselling

The job offer upselling entity list
Fields related to the upselling entity
Name Description

productId

The id of the upselling type.

productName

The name of this upselling.

beginDate

The starting date of this upselling. This field is always set to the current date.

endDate

The expiration date of this upselling. This field is always set to the current date plus the duration in days of the correspondent upselling.

state

The state of this upselling. This field is always set to 1 (active).

Error codes

Code Description

WS.1101

Invalid offer code. Null or empty string

WS.1102

The job offer code doesn't exist

WS.1103

The authenticated user doesn't have permission to edit the job offer

WS.1105

The state of the offer is not 'active'

WS.1115

The upsellings has invalid values

WS.1116

The offer has been removed previously"

WS.1117

You do not have enough stocks to add upsellings

WS.1118

The offer must be published into Infojobs corporative portal

WS.1119

Add upsellings is not allowed for international offers

WS.1120

Add upsellings is not allowed for offers of countries where is not allowed

Examples

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:off="http://offer.endpoints.www.soap.infojobs.net/">
    <soapenv:Header>   
      <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-799830164" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
            <wsse:Username>SOAP-TEST-CLIENT</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">SOAP-TEST-SECRET</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
       <ij:authnHeader xmlns:ij='http://api.infojobs.net/soap/authn'>
           <token>20000000-0000-0000-ws</token>
        </ij:authnHeader>
   </soapenv:Header>
   <soapenv:Body>
      <off:addUpsellings2Offer>
        <offerCode>39bca7eb124f58a6b0111469540591</offerCode>
        <upsellings>
            <upsellings>
                <productId>474</productId>
            </upsellings>
        </upsellings>
      </off:addUpsellings2Offer>
   </soapenv:Body>
</soapenv:Envelope

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <wsse:Security soap:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
         <wsu:Timestamp wsu:Id="TS-19222">
            <wsu:Created>2025-04-08T10:15:03.819Z</wsu:Created>
            <wsu:Expires>2025-04-08T10:20:03.819Z</wsu:Expires>
         </wsu:Timestamp>
      </wsse:Security>
   </soap:Header>
   <soap:Body>
        <ns1:addUpsellings2OfferResponse xmlns:ns1="http://offerV4.endpoints.www.soap.infojobs.net/">
            <return>
                <jobIndustryId>10</jobIndustryId>
                <jobReference></jobReference>
                <jobTitle>Simple offer title</jobTitle>
                <offerCode>39bca7eb124f58a6b0111469540591</offerCode>
                <provinceId>9</provinceId>
                <upsellingsDTO>
                    <upsellings>
                        <beginDate>2025-04-08T00:00:00+02:00</beginDate>
                        <endDate>2025-06-07T00:00:00+02:00</endDate>
                        <productId>474</productId>
                        <productName>Subir a las primeras posiciones</productName>
                        <state>1</state>
                        <stateDescription>Activo</stateDescription>
                    </upsellings>
                </upsellingsDTO>
            </return>
        </ns1:addUpsellings2OfferResponse>
   </soap:Body>
</soap:Envelope>

Request with additional province

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:off="http://offer.endpoints.www.soap.infojobs.net/">
<soapenv:Header>
  <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
     <wsse:UsernameToken wsu:Id="UsernameToken-799830164" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
        <wsse:Username>SOAP-TEST-CLIENT</wsse:Username>
        <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">SOAP-TEST-SECRET</wsse:Password>
     </wsse:UsernameToken>
  </wsse:Security>
   <ij:authnHeader xmlns:ij='http://api.infojobs.net/soap/authn'>
       <token>20000000-0000-0000-ws</token>
    </ij:authnHeader>
</soapenv:Header>
<soapenv:Body>
  <off:addUpsellings2Offer>
    <offerCode>39bca7eb124f58a6b0111469540591</offerCode>
    <upsellings>
        <upsellings>
            <productId>77</productId>
            <order>35</order>
        </upsellings>
        <upsellings>
            <productId>77</productId>
            <order>36</order>
        </upsellings>
    </upsellings>
  </off:addUpsellings2Offer>
</soapenv:Body>
</soapenv:Envelope

Response with additional province

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
  <wsse:Security soap:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
     <wsu:Timestamp wsu:Id="TS-19222">
        <wsu:Created>2025-04-08T10:15:03.819Z</wsu:Created>
        <wsu:Expires>2025-04-08T10:20:03.819Z</wsu:Expires>
     </wsu:Timestamp>
  </wsse:Security>
</soap:Header>
<soap:Body>
    <ns1:addUpsellings2OfferResponse xmlns:ns1="http://offerV4.endpoints.www.soap.infojobs.net/">
        <return>
            <jobIndustryId>10</jobIndustryId>
            <jobReference></jobReference>
            <jobTitle>Simple offer title</jobTitle>
            <offerCode>39bca7eb124f58a6b0111469540591</offerCode>
            <provinceId>9</provinceId>
            <upsellingsDTO>
                <upsellings>
                    <beginDate>2025-04-08T00:00:00+02:00</beginDate>
                    <endDate>2025-06-07T00:00:00+02:00</endDate>
                    <order>35</order>
                    <productId>77</productId>
                    <productName>Provincia adicional</productName>
                    <state>1</state>
                    <stateDescription>Activo</stateDescription>
                </upsellings>
                <upsellings>
                    <beginDate>2025-04-08T00:00:00+02:00</beginDate>
                    <endDate>2025-06-07T00:00:00+02:00</endDate>
                    <order>36</order>
                    <productId>77</productId>
                    <productName>Provincia adicional</productName>
                    <state>1</state>
                    <stateDescription>Activo</stateDescription>
                </upsellings>
            </upsellingsDTO>
        </return>
    </ns1:addUpsellings2OfferResponse>
</soap:Body>
</soap:Envelope>

Sections: