Skip to content

docs: record HR/ERP payroll integration boundary in supplier-payments-agent - #135

Open
fabianocruz wants to merge 1 commit into
mainfrom
docs/supplier-payments-hr-erp-payroll
Open

fabianocruz wants to merge 1 commit into
mainfrom
docs/supplier-payments-hr-erp-payroll

Conversation

@fabianocruz

Copy link
Copy Markdown
Member

Docs only. No code, no API contracts, no behavior changes.

What

Adds a short section to agents/supplier-payments-agent/README.md, "Where the payroll comes from: HR/ERP integration", and one pointer sentence to it from the "Not in this kit" line.

Why

Registering the agreed requirement for serving payroll cases well: the kit executes a payroll that is already calculated, and an integration with the HR/ERP system is the missing piece between the payables.ts fixture and a real company.

The boundary it records

  • Gross salary, deductions, charges, net per employee, tax and labor obligations, declarations and guias stay in the HR/payroll system or with the accountant. Paying the salaries settles none of them.
  • The integration flow: HR/ERP closes the payroll and hands over the list of employees and net amounts; finance approves (the same gesture the terminal already asks for); the agent executes the batch as one execution per line inside the mandate and guardrails; each line's outcome and receipt go back to the system of origin for reconciliation.
  • Failed lines are fixed at the source and re-run alone; re-running a batch pays nobody twice, which is what makes a reprocessed payroll safe.
  • The connector itself is integration work, not something this repository ships.

Opened for review; not to be merged by the author.

…-agent

Added section on HR/ERP integration and clarified payroll execution process.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant