{"schemaVersion":"1.0","sourceCommit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca","sourceVisibility":"private","article":{"id":"api-boundary-core-nphies-fatoora","title":"NPHIES and Fatoora in the current core integration boundary","summary":"Source boundary for NPHIES and Fatoora in the current core: 39 Python backend mappings, 8 client declarations and 0 service routes. Installation, mounts and production qualification require verification.","module":"NPHIES","roles":["IT administrator","Developer","Integration engineer"],"facilities":["All configured facility types"],"kind":"reference","minutes":3,"prerequisites":["Use the API contract from the installed deployment and an authorized synthetic test environment.","Confirm facility/organization scope, action permissions and optional app enablement.","This reference is static source evidence; complete payload, authorization, failure and end-to-end review remains recorded as pending."],"steps":[],"sections":[{"title":"Declared component boundary","body":"embedded core integration surfaces. Static implementation evidence is separate from NPHIES certification, authorized package pin, taxpayer/unit onboarding and production credential qualification."},{"title":"Routes and installation","body":"These are embedded core integration surfaces. Environment, authorized package, certification, certificate, taxpayer/unit and connector evidence must be qualified separately."},{"title":"Documentation evidence","body":"The pinned integration sources identify the package and operational boundary. The operation/schema inventory retains the concrete route evidence."},{"title":"Review status","body":"This article establishes repository/contract boundaries and does not prove installed capability, production credentials, regulator acceptance, security completeness or a validated click-by-click workflow."}],"troubleshooting":[{"problem":"A declared route is unavailable or a request is rejected","solution":"Compare the installed revision, actual API schema, optional plugin mount, HTTP-method restrictions and recorded validation/permission evidence. Do not bypass a refusal or send a production transaction to test documentation."}],"sources":[{"path":"repositories/platform/mansoq-core/mansoq/emr/rcm/nphies/package.py","line":12,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-core/mansoq/emr/rcm/services/zatca_exchange.py","line":1,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}],"related":["it-api-contract","it-api-auth","security-rcm-roles"],"verification":"Static API contract — behavior review pending","version":"f6e9f05f76d4","apiReferenceIds":["core-nphies-fatoora"]},"backend":{"resources":[],"operations":[],"methodEvidence":[],"schemas":[],"frameworkSettings":[{"name":"DEFAULT_AUTHENTICATION_CLASSES","value":["config.authentication.CustomJWTAuthentication","config.authentication.CustomBasicAuthentication","rest_framework.authentication.SessionAuthentication","rest_framework.authentication.TokenAuthentication"],"source":{"path":"repositories/platform/mansoq-core/config/settings/base.py","line":372,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"},{"name":"DEFAULT_PERMISSION_CLASSES","value":["rest_framework.permissions.IsAuthenticated","mansoq.security.utils.permission_class.MansoqAuthentication"],"source":{"path":"repositories/platform/mansoq-core/config/settings/base.py","line":372,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"},{"name":"DEFAULT_PAGINATION_CLASS","value":"mansoq.utils.pagination.mansoq_pagination.MansoqLimitOffsetPagination","source":{"path":"repositories/platform/mansoq-core/config/settings/base.py","line":372,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"},{"name":"PAGE_SIZE","value":14,"source":{"path":"repositories/platform/mansoq-core/config/settings/base.py","line":372,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"}]},"frontend":{"operations":[],"schemas":[]},"services":{"operations":[]},"boundaries":[{"id":"core-nphies-fatoora","repository":"repositories/platform/mansoq-core","title":"NPHIES and Fatoora in the current core","classification":"embedded core integration surfaces","backendOperationIds":["backend-resource-0e6bfac9c185f559:GET:nphies","backend-resource-0e6bfac9c185f559:POST:nphies","backend-resource-0e6bfac9c185f559:POST:nphies_communication","backend-resource-0e6bfac9c185f559:POST:nphies_payment_notice","backend-resource-0e6bfac9c185f559:POST:nphies_support","backend-resource-25719ce02eb21a4c:GET:list","backend-resource-25719ce02eb21a4c:POST:create","backend-resource-25719ce02eb21a4c:GET:retrieve","backend-resource-25719ce02eb21a4c:PATCH:partial_update","backend-resource-25719ce02eb21a4c:POST:bind_package","backend-resource-25719ce02eb21a4c:GET:readiness","backend-resource-25719ce02eb21a4c:POST:transition","backend-resource-25719ce02eb21a4c:POST:activate","backend-resource-25719ce02eb21a4c:POST:suspend","backend-resource-25719ce02eb21a4c:POST:supersede","backend-resource-25719ce02eb21a4c:POST:new_version","backend-resource-25719ce02eb21a4c:GET:evidence","backend-resource-25719ce02eb21a4c:GET:gates","backend-resource-494762949dcc3faa:GET:list","backend-resource-494762949dcc3faa:GET:retrieve","backend-resource-494762949dcc3faa:POST:ensure_for_invoice","backend-resource-494762949dcc3faa:POST:sign","backend-resource-494762949dcc3faa:POST:submit","backend-resource-494762949dcc3faa:POST:clear","backend-resource-494762949dcc3faa:POST:report","backend-resource-494762949dcc3faa:POST:reject","backend-resource-494762949dcc3faa:POST:regenerate","backend-resource-494762949dcc3faa:POST:dispatch_next_operation","backend-resource-8506d3d409500e82:GET:list","backend-resource-8506d3d409500e82:GET:retrieve","backend-resource-8506d3d409500e82:POST:prepare","backend-resource-8506d3d409500e82:POST:activate","backend-resource-8506d3d409500e82:POST:continue_checks","backend-resource-dbfd00182886d88f:GET:list","backend-resource-dbfd00182886d88f:GET:retrieve","backend-resource-dbfd00182886d88f:POST:prepare","backend-resource-dbfd00182886d88f:POST:submit","backend-resource-dbfd00182886d88f:GET:invoice_xml","backend-resource-dbfd00182886d88f:GET:invoice_pdf"],"frontendOperationIds":["frontend-operation-fbefff20cfd3cd0fd5","frontend-operation-0c71d9adbefdda9b91","frontend-operation-eea0a85e2c4a490193","frontend-operation-e9c922e51c9264a4f2","frontend-operation-e0d141324b0594713d","frontend-operation-920b72d29daca55170","frontend-operation-b91c2dac0bc19936c0","frontend-operation-8dc132230345679e6f"],"sources":[{"path":"repositories/platform/mansoq-core/mansoq/emr/rcm/nphies/package.py","line":12,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-core/mansoq/emr/rcm/services/zatca_exchange.py","line":1,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}],"availability":"Static implementation evidence is separate from NPHIES certification, authorized package pin, taxpayer/unit onboarding and production credential qualification."}]}