beel_create_customers_bulk

es.beel/mcp · Verify this server

Creates up to 500 customers of this company in a single call. - **Atomic:** if any customer fails validation the whole batch is rejected with `422` `BULK_VALIDATION_ERROR` and nothing is persisted. This is not a partial operation. - **`dry_run`:** with `dry_run=true` the batch is only validated — tax identifiers against the AEAT register, duplicates inside the batch and against the existing customers, field formats — nothing is written and the answer is `200`. With `dry_run=false`, the default, validation is followed by creation and the answer is `201`. - **Report:** both modes return the same per-record report, so a dry run and a real run are read the same way. Endpoint: POST /v1/companies/{company_id}/customers/bulk ⚠️ Fiscal guardrails — read before calling: - Why a name that does not match the census makes an invoice unsubmittable. (resource: beel://guardrails/nif-validation) For the exhaustive rules and worked examples, call beel_docs_search.