# Turn Segurança Social Direta into an API > Read each month's valores apurados (assessed values), the open documentos de pagamento and your situação contributiva from Segurança Social Direta with one API call each. Or have a workflow check every employer you represent before the confirmation deadline. Page: https://fous.com/automate/seguranca-social-direta Updated: 2026-11-12 Works with your own Segurança Social Direta account. Fous is an independent product. ## What you can build on SSD ### Get the valores apurados for a month Reads the values SSD assessed for one employer and one reference month, worker by worker, before you confirm or correct them. - Takes: Employer NISS, reference month - Returns: Worker NISS, remuneration, days of work, contribution rate, amount due, total ### List open documentos de pagamento Reads the payment documents that are not yet paid and still in term, with the payment reference for each. - Takes: Employer NISS - Returns: Document number, reference month, amount, payment reference, payment deadline ### Check the situação contributiva Reads whether the employer's contribution status is regularised and gets the declaração de situação contributiva (contribution status declaration). - Takes: Employer NISS - Returns: Employer NISS, regularised (yes or no), declaration link, checked at ### Communicate a new worker's admission Submits the comunicação de admissão (hiring notice) of a worker with the contract type and permanent remuneration, before the contract starts. - Takes: Employer NISS, worker NISS, contract type, start date, permanent remuneration - Returns: Worker NISS, start date, contract type, status, receipt number ## Automate SSD with a workflow A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use. ### Valores apurados to review before the confirmation deadline Starts: Every month on the 12th at 9:00 (Europe/Lisbon) 1. For each employer NISS you name, get the valores apurados for the previous month. 2. Keep the workers whose values changed since the last run, or who are new. 3. Email you the list, one section per employer, with remuneration, days and amount due. ### Open documentos de pagamento, posted to accounting Starts: Every month on the 15th at 8:00 (Europe/Lisbon) 1. For each employer NISS, list the open documentos de pagamento. 2. Stop when there are none. 3. Post document number, reference month, amount, payment reference and deadline to your accounting webhook. ### Weekly situação contributiva check, every employer Starts: Every Monday at 8:00 (Europe/Lisbon) 1. For each employer NISS you represent, check the situação contributiva. 2. Keep the employers whose situation is not regularised. 3. Email you those employers with the time of the check, or one line when all are regularised. You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month. ## Once built, one call from your code Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get the valores apurados for a month” would look like. Example request: ``` curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "method": "app.seg-social.pt/get_valores_apurados", "input": { "employer_niss": "20000000001", "reference_month": "2026-10" } }' ``` Example response: ``` { "status": "completed", "data": { "employer_niss": "20000000001", "reference_month": "2026-10", "workers": [ { "worker_niss": "11000000001", "remuneration": 1450, "days_of_work": 30, "contribution_rate": 34.75, "amount_due": 503.88 } ], "total_due": 823.58, "currency": "EUR" } } ``` An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request. ## SSD’s own options Segurança Social publishes web services (WSDL and YAML) on its Plataforma de Serviços de Interoperabilidade (PSI) for employers and their representatives, used through HR software with the SSD password. Citizens cannot use them on their own, and if your HR software does not integrate them, you build the connection yourself. SSD itself is used by hand. | Option | What it covers | What it takes | | --- | --- | --- | | PSI web services | Valores apurados and their confirmation, communicated values, documentos de pagamento, worker contracts and hires, and the situação contributiva. | An SSD registration and HR software that calls the services. With duplo fator on, a token or an application password. | | PSI Quality environment | A test copy of the services for building and checking an integration. | An email request to PSI support with your NISS and the requester's name and phone number. | | SSD by hand | The employer's contributions, payments, workers and declarations, through SSD's own screens. | An SSD registration. The palavra-chave (password) is posted to your address in about 5 days. | Read on November 12, 2026: [PSI services](https://www.plataformaservicos.seg-social.pt/psi/servicos.html), [PSI FAQ](https://www.plataformaservicos.seg-social.pt/psi/faqs.html), [PSI summary document, February 2026](https://www.plataformaservicos.seg-social.pt/psi/assets/docs/documento_sintese_2026_02.pdf). ## Signing in to SSD SSD signs you in with your palavra-chave (password), which Segurança Social posts to your address after you register. A main account can have subaccounts, and duplo fator (two-factor authentication) can be turned on. With Fous you sign in once through SSD's own sign-in with your own account: the login is sealed with AES-256, and a method reads and does only what that account can. ## Worth knowing - **Confirm by the 20th, pay by the 25th**: Since the 2026 rules, you confirm or correct the values the system assessed by day 20 of the following month. Unconfirmed values are registered as assessed, and payment runs from day 1 to day 25. - **Hires are due before the contract starts**: The comunicação de admissão is made in SSD before the contract starts, with the worker's NISS, the contract type and the remuneração permanente. Changes to permanent remuneration must also be communicated. - **Ten workers or more: the PSI is required**: Under the new contribution model, employers must send certain contribution communications through the PSI. Employers with fewer than 10 workers are exempt. - **Quality environment has a midday gap**: The PSI test environment is often unavailable between about 12:00 and 15:00 or 16:00, so plan integration tests outside those hours. ## More in Government: Southern, Eastern and Nordic Europe, EU - [Telemaco](https://fous.com/automate/telemaco.md) - [EUDR Information System](https://fous.com/automate/eudr-information-system.md) - [Road Transport Posting Declaration Portal](https://fous.com/automate/road-transport-posting-declaration-portal.md) - [EU Funding & Tenders Portal](https://fous.com/automate/eu-funding-and-tenders-portal.md) - [Cégkapu](https://fous.com/automate/cegkapu.md) - [UETS](https://fous.com/automate/uets.md) - [EPREL](https://fous.com/automate/eprel.md) - [e-Zamówienia](https://fous.com/automate/e-zamowienia.md) - [Mercell](https://fous.com/automate/mercell.md) - [NEN](https://fous.com/automate/nen.md) - [Plataforma de Contratación del Sector Público](https://fous.com/automate/plataforma-de-contratacion-del-sector-publico.md) - [Prozorro](https://fous.com/automate/prozorro.md) - [TRACES NT](https://fous.com/automate/traces-nt.md) - [e-ΕΦΚΑ](https://fous.com/automate/e-efka.md) - [PUE ZUS](https://fous.com/automate/pue-zus.md) - [SGK İşveren Sistemi](https://fous.com/automate/sgk-isveren-sistemi.md) - [Sociálna poisťovňa e-Služby](https://fous.com/automate/socialna-poistovna-e-sluzby.md) - [Dijital Vergi Dairesi](https://fous.com/automate/dijital-vergi-dairesi.md) - [myAADE](https://fous.com/automate/myaade.md) - [Portal das Finanças](https://fous.com/automate/portal-das-financas.md) - [e-Beyanname](https://fous.com/automate/e-beyanname.md) Other industries: [FCA RegData](/automate/fca-regdata), [USA North 811](/automate/usa-north-811), [NFI Online](/automate/nfi-online), [USCIS online account](/automate/uscis-online-account), [Bonfire](/automate/bonfire), [myPATH](/automate/mypath). ## Frequently asked questions ### Does Segurança Social Direta have an API? Yes, for employers and their representatives through HR software. The PSI publishes web services for valores apurados, documentos de pagamento, workers and contracts, and the situação contributiva, used with your SSD password. Citizens cannot use them on their own. ### What changed for monthly contributions in 2026? You now confirm or correct the values the system assessed by day 20 of the following month, and pay from day 1 to day 25. Values you do not confirm are registered as assessed. Working time is declared in days, at most 30. ### Can I get the declaração de situação contributiva automatically? Yes. The PSI service Consultar Situação Contributiva returns whether the situation is regularised and a link to the declaration. With Fous, a method you build can read the same in SSD with your own account and return it as JSON. ### Which password do the PSI web services use? Your SSD password. There is no separate registration. When duplo fator is on, you create a token or an application password for the services instead, as the PSI's authentication diagram shows. ### Is Fous affiliated with Segurança Social? No. Fous is an independent product. You use it with your own Segurança Social Direta account, and a method reads and does only what that account can. Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Segurança Social Direta (Segurança Social). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.