« Back to SOAP operation list

offerstock

Returns the authenticated employer offer stock and the related offer codes.

Request

WSDL Production URL

https://api.infojobs.net/soap/WSOfferstockService?wsdl

WSDL Testing URL

https://api.infojobssbx.net/soap/WSOfferstockService?wsdl

Security

  • User Role: role_employer
  • Scope: employer_offerstock_read

Response

Response fields

Fields related to offerStock entity
Name Description

availableActivePositions

Integer

The available active positions count.

availableArchivedPositions

Integer

The available archived positions count.

contractedActivePositions

Integer

The contracted active positions count.

activePositionsExpirationDate

Date

The date on which it will expire the contrated active positions in RFC_3339 format including milliseconds: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

contractedArchivedPositions

Integer

The contracted archived positions count.

archivedPositionsExpirationDate

Date

The date on which it will expire the contrated archived positions in RFC_3339 format including milliseconds: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

availableOfferCreationStock

Integer

The available offer creation stock.

activeOffers

List(Offer)

Nullable

The job offers that currently occupy active positions.

archivedOffers

List(Offer)

Nullable

The job offers that currently occupy archived positions.

Fields related to Offer entity
Name Description

id

String

The job offer identifier.

Maximum length: 100

title

String

Title of the job offer

Maximum length: 150

creationDate

Date

Date of the job offer creation in RFC_3339 format including milliseconds: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

expirationDate

Date

The job offer expiration in in RFC_3339 format including milliseconds: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

link

String

URL of the job offer published at Infojobs portal.

Maximum length: 1000

Portal de Empresa equivalences

The following table maps each API field to the product or concept shown in the Portal de Empresa, to help compare data obtained through the API with the information displayed in the portal.

API field to Portal de Empresa product/concept
API field Portal product / concept

contractedActivePositions

Active Offer limit

availableActivePositions

Available active positions

activePositionsExpirationDate

Active Offer end date

contractedArchivedPositions

Archived Offer limit

availableArchivedPositions

Available archived positions

archivedPositionsExpirationDate

Archived Offer end date

availableOfferCreationStock

Available offer insertion stock

activeOffers

Offers currently consuming active positions

archivedOffers

Offers currently consuming archived positions

Unlimited products representation

Unlimited products are represented in the API response with the value 1000000.

Contracted product to API value
Contracted product Value returned by the API

100 active offers

100

500 active offers

500

Unlimited active offer

1000000

Error codes

Code Description

WS.150

Expired access token

WS.152

Access Token is required

WS.153

Access token not authorized for this operation

WS.154

Invalid access token

WS.155

Invalid access token

WS.156

Wrong access token

WS.2106

Employer offer stock operation not available for the authenticated user.

Examples

This example shows the detail of a offer.

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</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">SOAP-TEST-PASSWORD</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
<ij:authnHeader xmlns:ij='http://api.infojobs.net/soap/authn'>
<token>20000000-0000-0000</token>
</ij:authnHeader>
</soapenv:Header>
<soapenv:Body>
      <off:getOfferstock>
      </off:getOfferstock>
   </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-54">
            <wsu:Created>2020-01-20T09:31:45.953Z</wsu:Created>
            <wsu:Expires>2020-01-20T09:36:45.953Z</wsu:Expires>
         </wsu:Timestamp>
      </wsse:Security>
   </soap:Header>
   <soap:Body>
      <ns1:getOfferstockResponse xmlns:ns1="http://offerstock.endpoints.www.soap.infojobs.net/">
         <WSEmployerOfferstockResponseBean>
            <activePositionsExpirationDate>2020-12-12T00:00:00+01:00</activePositionsExpirationDate>
            <archivedOffers>
               <creationDate>2015-02-03T13:12:59+01:00</creationDate>
               <expirationDate>2015-04-04T00:00:00+02:00</expirationDate>
               <id>6f5c71a04e48b7ac08acc381923ba1</id>
               <link>https://www.infojobs.net/madrid/pepe-luis/of-i6f5c71a04e48b7ac08acc381923ba1</link>
               <title>pepe luis</title>
            </archivedOffers>
            <archivedPositionsExpirationDate>2020-12-12T00:00:00+01:00</archivedPositionsExpirationDate>
            <availableActivePositions>5</availableActivePositions>
            <availableArchivedPositions>10</availableArchivedPositions>
            <availableOfferCreationStock>1000000</availableOfferCreationStock>
            <contractedActivePositions>5</contractedActivePositions>
            <contractedArchivedPositions>20</contractedArchivedPositions>
         </WSEmployerOfferstockResponseBean>
      </ns1:getOfferstockResponse>
   </soap:Body>
</soap:Envelope>

Sections: