[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6},"actionData","errors","routes/docs",{"_7":8,"_9":10,"_11":-7,"_12":13,"_14":15},"type","openapi","title","Get Open Api V2","description","pageTree",{"_5742":5743,"_421":5744},"props",{"_16":17,"_18":19,"_20":21,"_22":23},"payload",{"_32":33,"_34":35},"document","./public/openapi/apifact-v2.json","operations",[24],"showDescription",true,{"_25":26,"_27":28,"_29":30},"method","get","path","/api/v2/openapi.json","tags",[31],"System","bundled",{"_8":36,"_37":38,"_39":40,"_29":41,"_42":43,"_44":45},"proxyUrl","/api/playground","3.2.0","info",{"_9":5739,"_445":5740,"_11":5741},"servers",[5733,5734],[5722,5723,5724,5725,5726,5727,5728,5729,5730,5731,5732],"paths",{"_2472":2473,"_28":2474,"_2475":2476,"_2477":2478,"_2479":2480,"_2481":2482,"_2483":2484,"_2485":2486,"_2487":2488,"_2489":2490,"_2491":2492,"_2493":2494,"_2495":2496,"_2497":2498,"_2499":2500,"_2501":2502,"_2503":2504,"_2505":2506,"_2507":2508,"_2509":2510,"_2511":2512,"_2513":2514,"_2515":2516,"_2517":2518,"_2519":2520,"_2521":2522,"_2523":2524,"_2525":2526,"_2527":2528,"_2529":2530,"_2531":2532,"_2533":2534,"_2535":2536,"_2537":2538,"_2539":2540,"_2541":2542,"_2543":2544,"_2545":2546,"_2547":2548,"_2549":2550},"components",{"_46":47,"_48":49},"securitySchemes",{"_2464":2465},"schemas",{"_50":51,"_52":53,"_54":55,"_56":57,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95,"_96":97,"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":111,"_112":113,"_114":115,"_116":117,"_118":119,"_120":121,"_122":123,"_124":125,"_126":127,"_128":129,"_130":131,"_132":133,"_134":135,"_136":137,"_138":139,"_140":141,"_142":143,"_144":145,"_146":147,"_148":149,"_150":151,"_152":153,"_154":155,"_156":157,"_158":159,"_160":161,"_162":163,"_164":165,"_166":167,"_168":169,"_170":171,"_172":173,"_174":175,"_176":177,"_178":179,"_180":181,"_182":183,"_184":185,"_186":187,"_188":189,"_190":191,"_192":193,"_194":195,"_196":197,"_198":199,"_200":201,"_202":203,"_204":205,"_206":207,"_208":209,"_210":211,"_212":213,"_214":215,"_216":217,"_218":219,"_220":221,"_222":223,"_224":225,"_226":227,"_228":229,"_230":231,"_232":233,"_234":235,"_236":237,"_238":239,"_240":241,"_242":243},"CreateOrganizationCompanyRequest",{"_7":244,"_245":246,"_247":2455,"_249":2456},"OrganizationCompanyResponse",{"_7":244,"_245":246,"_247":2437,"_249":2438},"MintCompanyCredentialRequest",{"_7":244,"_245":246,"_247":2413,"_249":2414},"MintedCompanyCredentialResponse",{"_7":244,"_245":246,"_247":2393,"_249":2394},"OrganizationUsageEntry",{"_7":244,"_245":246,"_247":2368,"_249":2369},"OrganizationUsageResponse",{"_7":244,"_245":246,"_247":2356,"_249":2357},"CompanyCapabilityState",{"_7":244,"_245":246,"_247":2348,"_249":2349},"CertificateActivationState",{"_7":244,"_245":246,"_11":2329,"_247":2330,"_249":2331},"CertificateVersionState",{"_7":244,"_245":246,"_11":2304,"_247":2305,"_249":2306},"CompanyCertificateState",{"_7":244,"_245":246,"_11":2293,"_247":2294,"_249":2295},"OrganizationCompanyState",{"_7":244,"_245":246,"_11":2269,"_247":2270,"_249":2271},"CompanyCredentialState",{"_7":244,"_245":246,"_11":2235,"_247":2236,"_249":2237},"OrganizationCompanyListResponse",{"_7":244,"_245":246,"_247":2218,"_249":2219},"OrganizationCompanyDetailResponse",{"_7":244,"_245":246,"_247":2202,"_249":2203},"LegacyInvoiceCreateRequest",{"_7":244,"_245":246,"_247":2088,"_249":2089,"_944":2090},"LegacyInvoiceReferenceRequest",{"_7":244,"_245":246,"_247":2064,"_249":2065},"LegacyInvoiceResponse",{"_7":244,"_245":246,"_247":2042,"_249":2043},"LegacyErrorEnvelope",{"_7":244,"_245":246,"_247":2024,"_249":2025},"Party",{"_7":244,"_245":246,"_247":2009,"_249":2010},"Supplier",{"_7":244,"_777":2001},"NoteParty",{"_777":1993},"NoteSupplier",{"_777":1983},"LineAllowanceCharge",{"_7":244,"_245":246,"_247":1973,"_11":1974,"_249":1975},"DocumentAllowanceCharge",{"_7":244,"_245":246,"_247":1962,"_11":1963,"_249":1964},"InvoiceLine",{"_7":244,"_245":246,"_247":1916,"_249":1917},"NoteLine",{"_777":1899},"Decimal",{"_7":268,"_309":1896,"_1663":1897},"PositiveDecimal",{"_7":268,"_309":1894,"_1663":1895},"Detraction",{"_7":244,"_245":246,"_247":1875,"_11":1876,"_249":1877},"Installment",{"_7":244,"_245":246,"_247":1865,"_11":1866,"_249":1867},"InvoiceCustomer",{"_777":1855},"AffectedInvoiceReference",{"_7":244,"_245":246,"_247":1835,"_944":1836,"_249":1837},"CreateDocumentRequest",{"_7":244,"_245":246,"_944":1666,"_247":1667,"_249":1668},"SummaryAmount",{"_7":268,"_309":1661,"_11":1662,"_1663":1664},"SummaryIssuer",{"_7":244,"_245":246,"_247":1653,"_249":1654},"SummaryCustomer",{"_7":244,"_245":246,"_247":1646,"_11":1647,"_249":1648},"SummaryTaxes",{"_7":244,"_245":246,"_247":1635,"_11":1636,"_249":1637},"SummaryBillingPayments",{"_7":244,"_245":246,"_11":1625,"_249":1626},"SummaryAffectedDocument",{"_7":244,"_245":246,"_247":1618,"_11":1619,"_249":1620},"SummaryLine",{"_7":244,"_245":246,"_247":1584,"_249":1585},"VoidedLine",{"_7":244,"_245":246,"_247":1574,"_249":1575},"CreateSummaryRequest",{"_7":244,"_245":246,"_247":1558,"_249":1559},"CreateVoidedCommunicationRequest",{"_7":244,"_245":246,"_247":1540,"_249":1541},"VoidedDeadline",{"_7":244,"_245":246,"_247":1528,"_11":1529,"_249":1530},"SummaryOperationResponse",{"_7":244,"_245":246,"_247":1514,"_249":1515},"SummaryResponse",{"_7":244,"_245":246,"_247":1462,"_249":1463},"SummaryReferenceCounts",{"_7":244,"_245":246,"_247":1453,"_11":1454,"_249":1455},"SummaryState",{"_7":268,"_11":1451,"_271":1452},"PaymentRegimeParty",{"_7":244,"_245":246,"_247":1418,"_11":1419,"_249":1420},"PaymentRegimePayment",{"_7":244,"_245":246,"_247":1411,"_11":1412,"_249":1413},"PaymentRegimeExchangeRate",{"_7":244,"_245":246,"_247":1399,"_11":1400,"_249":1401},"RetentionDocumentReference",{"_7":244,"_245":246,"_247":1385,"_249":1386},"PerceptionDocumentReference",{"_7":244,"_245":246,"_247":1367,"_249":1368},"CreateRetentionRequest",{"_7":244,"_245":246,"_247":1344,"_249":1345},"CreatePerceptionRequest",{"_7":244,"_245":246,"_247":1310,"_249":1311},"PaymentRegimeOperationResponse",{"_7":244,"_245":246,"_247":1296,"_249":1297},"PaymentRegimeReference",{"_7":244,"_245":246,"_247":1256,"_11":1257,"_249":1258},"PaymentRegimeResponse",{"_7":244,"_245":246,"_247":1194,"_249":1195},"PaymentRegimeState",{"_7":268,"_11":1192,"_271":1193},"DocumentOperationResponse",{"_7":244,"_245":246,"_247":1183,"_249":1184},"ValidationFinding",{"_7":244,"_245":246,"_247":1174,"_249":1175},"DocumentTotals",{"_7":244,"_245":246,"_247":1107,"_249":1108},"DocumentValidationResponse",{"_7":244,"_245":246,"_247":1091,"_249":1092},"DocumentResponse",{"_7":244,"_245":246,"_247":1059,"_249":1060},"SunatResponseGuidance",{"_7":244,"_245":246,"_247":1025,"_249":1026},"OperationResponse",{"_7":244,"_245":246,"_247":993,"_249":994},"ArtifactListResponse",{"_7":244,"_245":246,"_247":983,"_249":984},"PaginatedArtifactListResponse",{"_7":244,"_245":246,"_247":961,"_249":962},"GeneratePdfRequest",{"_7":244,"_245":246,"_247":938,"_249":939},"PdfGenerationResponse",{"_7":244,"_245":246,"_247":922,"_249":923},"PdfRepresentationMetadata",{"_7":244,"_245":246,"_247":890,"_249":891},"ArtifactMetadata",{"_7":244,"_245":246,"_247":865,"_249":866},"DocumentState",{"_7":268,"_271":852},"DocumentFiscalState",{"_7":268,"_11":846,"_271":847},"WebhookEventType",{"_7":268,"_11":836,"_271":837},"WebhookDestination",{"_7":268,"_269":832,"_732":833,"_632":834,"_11":835},"CreateWebhookSubscriptionRequest",{"_7":244,"_245":246,"_247":826,"_249":827},"UpdateWebhookSubscriptionRequest",{"_7":244,"_245":246,"_815":447,"_249":816},"WebhookSubscription",{"_7":244,"_245":246,"_247":796,"_249":797},"WebhookSubscriptionResponse",{"_777":786},"WebhookSubscriptionCreatedResponse",{"_777":778},"WebhookSubscriptionListResponse",{"_7":244,"_245":246,"_247":768,"_249":769},"WebhookSubscriptionDeletedResponse",{"_7":244,"_245":246,"_247":759,"_249":760},"WebhookSecretRotationResponse",{"_7":244,"_245":246,"_247":745,"_249":746},"EnrollCertificateRequest",{"_7":244,"_245":246,"_247":718,"_249":719},"CertificateVersion",{"_7":244,"_245":246,"_247":684,"_249":685},"CertificateVersionActivation",{"_7":244,"_245":246,"_247":669,"_249":670},"CertificateEnrolledResponse",{"_7":244,"_245":246,"_247":639,"_249":640},"CertificateEnrollmentReplayResponse",{"_7":244,"_245":246,"_247":580,"_249":581},"CertificateListResponse",{"_7":244,"_245":246,"_247":571,"_249":572},"CertificateActivationAcceptedResponse",{"_7":244,"_245":246,"_247":523,"_249":524},"CertificateActivationStatusResponse",{"_7":244,"_245":246,"_247":462,"_249":463},"WebhookDeliveryEnvelope",{"_7":244,"_245":246,"_11":407,"_247":408,"_249":409},"TaxpayerConsultationResponse",{"_7":244,"_245":246,"_11":349,"_247":350,"_249":351},"ExchangeRateConsultationResponse",{"_7":244,"_245":246,"_247":313,"_249":314},"DniConsultationResponse",{"_7":244,"_245":246,"_11":274,"_247":275,"_249":276},"ErrorEnvelope",{"_7":244,"_245":246,"_247":248,"_249":250},"object","additionalProperties",false,"required",[251,253,255],"properties",{"_251":252,"_253":254,"_255":256},"schemaVersion",{"_7":268,"_271":272},"requestId",{"_7":268,"_269":270},"error",{"_7":244,"_245":246,"_247":257,"_249":258},[259,261],{"_259":260,"_261":262,"_263":264},"code",{"_7":268},"message",{"_7":268},"details",{"_7":265,"_266":267},"array","items",{"_7":244,"_245":23},"string","format","uuid","enum",[273],"2.0","Informational only. Nothing on the issuing path resolves a DNI: a boleta whose acquirer name was typed by hand is issued exactly as before, and a 502 or 503 from this route does not affect document issuance. THERE ARE TWO ANSWERS AND SEVEN NON-ANSWERS. found=true and found=false are both 200 and are both statements about the person; every failure to obtain an answer is a 502 (the directory answered something unusable) or a 503 (the directory produced no answer), each with its own error code, and NONE of them may be read as found=false. A client that folds DNI_DIRECTORY_UNAVAILABLE into 'this person does not exist' turns an outage of ours into a refused customer.",[251,253,279,281,283,285],{"_251":277,"_253":278,"_279":280,"_281":282,"_283":284,"_285":286},{"_7":268,"_271":312},{"_7":268,"_269":270},"dni",{"_7":268,"_309":310,"_11":311},"found",{"_7":307,"_11":308},"consultedAt",{"_7":268,"_269":305,"_11":306},"person",{"_7":287,"_245":246,"_11":288,"_247":289,"_249":290},[244,303],"Null exactly when found is false. NAMES ONLY: this API requests the directory's minimal endpoint, so no birth date and no gender are ever obtained, transported or available — a boleta needs neither, and Ley 29733's minimisation principle makes asking for them the wrong default rather than a missing feature.",[291,293,295,297,299],{"_291":292,"_293":294,"_295":296,"_297":298,"_299":300},"fullName",{"_7":268,"_11":304},"firstNames",{"_7":268},"paternalSurname",{"_7":268},"maternalSurname",{"_7":268},"verificationDigit",{"_7":301,"_11":302},[268,303],"RENIEC's codigo_verificacion: a check digit of the DNI that was supplied, not a further fact about the person. Null when the directory omitted it, which never costs the caller the name.","null","The registry's own composition of the full name, preferred over one assembled from the parts: the order of two surnames is RENIEC's to decide, not this API's.","date-time","When this answer was obtained. This surface never serves a stored answer — there is no cache — so this is always the instant of a live consultation, and it is the instant to record beside any name you keep.","boolean","Whether the registry holds a record for this DNI. FALSE IS A REAL, SUCCESSFUL ANSWER: the directory was reached, answered, and has no such record. It is not the same as this API being unable to ask, which is never a 200.","pattern","^[0-9]{8}$","The DNI that was asked about, echoed from the request path and never from the directory's own response.",[273],[251,253,317,319,321,323,325,327,329,331],{"_251":315,"_253":316,"_317":318,"_319":320,"_321":322,"_323":324,"_325":326,"_327":328,"_329":330,"_331":332},{"_7":268,"_271":348},{"_7":268,"_269":270},"currency",{"_7":268,"_309":346,"_11":347},"requestedOn",{"_7":268,"_269":343,"_11":345},"rateDate",{"_7":268,"_269":343,"_11":344},"buyRate",{"_7":268,"_309":340,"_11":342},"sellRate",{"_7":268,"_309":340,"_11":341},"source",{"_7":268,"_309":338,"_11":339},"fallback",{"_7":307,"_11":337},"stalenessDays",{"_7":333,"_334":335,"_11":336},"integer","minimum",0,"Calendar days between rateDate and requestedOn; 0 when fallback is false. Published because it is the only way to tell an ordinary weekend (2, or 3 over a Monday holiday) from a loader that stopped running (40). This API imposes NO ceiling — the norm has none, and refusing past an invented threshold would refuse an answer the norm considers correct — so any threshold is the caller's to choose.","True when rateDate differs from requestedOn, i.e. the answer was carried forward under 'el último publicado' because the requested date had no publication. Weekends and holidays make this the normal case, not an error. A caller that displays the rate must display rateDate with it when this is true.","^[A-Z][A-Z0-9_]*$","Who published the series this row came from, e.g. SBS. Recorded so a hand-entered row and a published one stay distinguishable.","^[0-9]+\\.[0-9]{6}$","Tipo de cambio promedio ponderado venta, six decimals, as a string for the same reason as buyRate. THIS IS THE IGV ANSWER: D.S. 29-94-EF artículo 5 numeral 17 names the venta rate flatly, for sales and purchases alike.","Tipo de cambio compra, six decimals. A STRING, to be parsed as a decimal: this number gets multiplied into money and a binary float is where it would change value. Not the IGV answer — it is here because the Impuesto a la Renta rule splits compra/venta by activo/pasivo.","date","The date this rate was actually PUBLISHED FOR. Equal to requestedOn on a publication day; earlier when the último-publicado rule carried an earlier publication forward. Never later than requestedOn: the resolution never looks ahead, so a Sunday resolves back to Friday and not forward to Monday.","The date that was asked about, echoed back. Never a server-side 'today'.","^[A-Z]{3}$","The requested currency, upper-cased. USD is the only series loaded.",[273],"Informational only. A registered=false answer does not prevent, discourage or flag a comprobante issued to this RUC; nothing on the issuing path reads this catalogue.",[251,253,354,356,358,360],{"_251":352,"_253":353,"_354":355,"_356":357,"_358":359,"_360":361},{"_7":268,"_271":406},{"_7":268,"_269":270},"ruc",{"_7":268,"_309":394,"_11":405},"registered",{"_7":307,"_11":404},"registry",{"_7":244,"_245":246,"_11":395,"_247":396,"_249":397},"taxpayer",{"_7":362,"_245":246,"_11":363,"_247":364,"_249":365},[244,303],"Null exactly when registered is false.",[354,367,369,371,373,375],{"_354":366,"_367":368,"_369":370,"_371":372,"_373":374,"_375":376},{"_7":268,"_309":394},"legalName",{"_7":268,"_11":393},"status",{"_7":268,"_11":392},"statusClass",{"_7":268,"_271":386,"_11":387},"condition",{"_7":268,"_11":385},"conditionClass",{"_7":268,"_271":377,"_11":378},[379,380,381,382,383,384],"This API's coarse classification of `condition`. NO_HALLADO and NO_HABIDO are different findings and are kept apart. UNKNOWN means SUNAT published a value this API does not map, including the literal '-' that many rows carry, and is never reported as HABIDO.","HABIDO","NO_HABIDO","NO_HALLADO","NOT_APPLICABLE","PENDING","UNKNOWN","SUNAT's literal CONDICIÓN DE DOMICILIO, verbatim and authoritative, truncated to 20 characters by SUNAT in the same way as `status`.",[388,389,390,383,391,384],"This API's coarse classification of `status`, so an integrator does not have to compare Spanish strings. UNKNOWN means SUNAT published a value this API does not map — it is never a guess, and the literal beside it is what to fall back on. OTHER covers real SUNAT states that are neither alive nor withdrawn, such as NUM. INTERNO IDENTIF and OTROS OBLIGADOS.","ACTIVE","INACTIVE","SUSPENDED","OTHER","SUNAT's literal ESTADO DEL CONTRIBUYENTE, verbatim and authoritative. SUNAT truncates these to 20 characters in the padrón reducido, so values such as 'BAJA PROV. POR OFICI' arrive without their closing letters; that is the published value, not a defect. Match on statusClass rather than on this string unless you need the exact wording.","SUNAT's razón social or nombre comercial as published.","^[0-9]{11}$","Which snapshot answered. Present on both outcomes, so the age of a negative answer is as readable as the age of a positive one.",[398,400],{"_398":399,"_400":401},"publishedOn",{"_7":268,"_269":343,"_11":403},"rowCount",{"_7":333,"_334":335,"_11":402},"How many taxpayers the serving snapshot holds.","SUNAT's own publication date for the loaded snapshot, never the time this API ingested it. This is how old the answer is.","Whether this RUC is present in the snapshot named by `registry`. FALSE IS A REAL, SUCCESSFUL ANSWER and means the snapshot was consulted and does not contain it — not that this API could not answer, which is 503 TAXPAYER_REGISTRY_UNAVAILABLE. Because the snapshot is always behind, false also does not mean the RUC cannot be invoiced.","The RUC that was asked about, echoed back.",[273],"POSTed with content-type application/json. Headers: Apifact-Signature (t=,v1=), Apifact-Timestamp, Apifact-Event-Id, Apifact-Event-Type, Apifact-Schema-Version, Apifact-Subscription-Id, Apifact-Secret-Version, Apifact-Delivery-Id, Apifact-Delivery-Attempt. Verify by recomputing HMAC-SHA256 over the literal 'apifact:webhook:v1' + NUL + the t value + NUL + the RAW body, comparing in constant time, and rejecting a t outside a 300-second window. The attempt counter is a header, not a body field, so the signed bytes are identical on every retry. Deduplicate on eventId. Answer 2xx to acknowledge; any other status, or a redirect, is retried with exponential backoff up to 12 attempts and then dead-lettered.",[251,411,413,415,417,419,421],{"_251":410,"_411":412,"_413":414,"_415":416,"_417":418,"_419":420,"_421":422},{"_7":268,"_309":460,"_11":461},"eventId",{"_7":268,"_269":270},"eventType",{"_452":459},"occurredAt",{"_7":268,"_269":305},"subscriptionId",{"_7":268,"_269":270},"deliveryId",{"_7":268,"_269":270},"data",{"_7":244,"_11":423,"_245":23,"_249":424},"Identifiers and state only. Never the canonical payload, the signed XML, the CDR, customer data or any amount: a webhook notifies that something happened to a document the caller already owns, it is not a second unauthenticated read API.",{"_425":426,"_427":428,"_429":430,"_431":432,"_433":434,"_435":436,"_437":438,"_439":440,"_441":442,"_443":444,"_445":446},"documentId",{"_7":268,"_269":270},"operationId",{"_7":268,"_269":270},"documentType",{"_7":268,"_271":454},"series",{"_7":268},"number",{"_7":268},"state",{"_452":453},"previousState",{"_7":451},"stateVersion",{"_7":333,"_334":447},"representationId",{"_7":268,"_269":270},"kind",{"_7":268,"_271":448},"version",{"_7":333,"_334":447},1,[449,450],"pdf-a4","pdf-ticket",[268,303],"$ref","#/components/schemas/DocumentState",[455,456,457,458],"01","03","07","08","#/components/schemas/WebhookEventType","^[0-9]+\\.[0-9]+$","Payload version of this event type, currently 1.0 for the whole catalog. Refuse a major version you do not implement rather than guessing.",[251,253,466,468,445,471,369,474,476,478,480],{"_251":464,"_253":465,"_466":467,"_468":469,"_445":470,"_471":472,"_369":473,"_474":475,"_476":477,"_478":479,"_480":481},{"_7":268,"_271":522},{"_7":268,"_269":270},"activationId",{"_7":268,"_269":270},"id",{"_7":268,"_269":270},{"_7":333,"_334":447},"environment",{"_7":268,"_271":519},{"_7":268,"_271":512,"_11":513},"certificateStatus",{"_7":268,"_271":507,"_11":508},"probe",{"_7":244,"_245":246,"_247":484,"_249":485},"createdAt",{"_7":268,"_269":305},"finishedAt",{"_7":482,"_269":305,"_11":483},[268,303],"Null while the probe is PENDING or PROBING.",[429,431,433,489,491,493,495],{"_429":486,"_431":487,"_433":488,"_489":490,"_491":492,"_493":494,"_495":496},{"_7":268,"_271":506},{"_7":268,"_271":504},{"_7":268},"responseCode",{"_7":502,"_11":503},"responseMessage",{"_7":500,"_11":501},"failureCode",{"_7":498,"_11":499},"probedAt",{"_7":497,"_269":305},[268,303],[268,303],"Set instead of a SUNAT code when the probe failed on this side, before or without an answer from SUNAT.",[268,303],"SUNAT's cbc:Description for the probe, verbatim.",[268,303],"SUNAT's cbc:ResponseCode for the probe, verbatim. Null until SUNAT has answered. This is the field that names which rule a rejected certificate broke.",[505],"F000",[455],[509,510,388,511],"The version's own status, which is a different question from the probe's. Only status ACTIVATED leaves this ACTIVE; every other terminal probe leaves it DRAFT. PENDING_FIRST_ISSUE never appears beside a probe — it belongs to the PRODUCTION path, which has no attempt — and is listed because this field reports the version and the version has four states.","DRAFT","PENDING_FIRST_ISSUE","RETIRED",[383,514,515,516,517,518],"The probe. PENDING is recorded and not yet dispatched, PROBING is in flight at SUNAT. ACTIVATED means SUNAT accepted the comprobante and the version is now ACTIVE. REJECTED means SUNAT answered and refused it, so the certificate cannot issue and the version stays DRAFT. AMBIGUOUS means the comprobante may have reached SUNAT and no answer came back; it is never redispatched automatically, and the version stays DRAFT. FAILED is a local failure before SUNAT saw anything.","PROBING","ACTIVATED","REJECTED","AMBIGUOUS","FAILED",[520,521],"BETA","PRODUCTION",[273],[251,253,527,427,466,468,532,445,471,369,474,476,539,478,542],{"_251":525,"_253":526,"_527":528,"_427":529,"_466":530,"_468":531,"_532":533,"_445":534,"_471":535,"_369":536,"_474":537,"_476":538,"_539":540,"_478":541,"_542":543},{"_7":268,"_271":570},{"_7":268,"_269":270},"mechanism",{"_7":268,"_271":566,"_11":567},{"_7":564,"_269":270,"_11":565},{"_7":563,"_269":270},{"_7":268,"_269":270,"_11":562},"resourceId",{"_7":268,"_269":270},{"_7":333,"_334":447},{"_7":268,"_271":561},{"_7":268,"_271":559,"_11":560},{"_7":268,"_271":557,"_11":558},{"_7":546,"_245":246,"_247":547,"_11":548,"_249":549},"statusPath",{"_7":268,"_11":545},{"_7":268,"_269":305},"replay",{"_7":307,"_11":544},"True when a repeated Idempotency-Key adopted the attempt already recorded, rather than opening a second one.","Where the verdict is read. Repeated in the Location header.",[244,303],[429,431,433],"The comprobante that will be issued against SUNAT beta. It is a real document at SUNAT under this tenant's RUC and it is not a row in this API's document collections. NULL when mechanism is FIRST_ISSUE: no probe exists, and the comprobante that will prove this certificate is one the taxpayer has not written yet.",{"_429":550,"_431":551,"_433":552},{"_7":268,"_271":556},{"_7":268,"_271":554,"_11":555},{"_7":268,"_11":553},"The enrolment version, so a version is probed at most once and no probe number is ever reused.",[505],"Reserved for probes. A tenant issuing on F000 is refused with 422 INVALID_DOCUMENT, because its own F000 would collide with a number SUNAT already holds.",[455],[509,510],"The version's own status. DRAFT under mechanism PROBE, and that is the point of the 202: requesting activation changes nothing, and whatever signs this company's documents keeps signing them until SUNAT accepts the probe. PENDING_FIRST_ISSUE under mechanism FIRST_ISSUE, and that one DOES change what signs: from this response onwards the company's documents are signed with this version. It is not ACTIVE and must not be read as ACTIVE — a version that signs and has not yet been accepted by SUNAT is precisely what the fourth status exists to say.",[383,510],"PENDING is the probe's status under mechanism PROBE: the attempt is recorded and nothing has been sent yet. PENDING_FIRST_ISSUE is the certificate VERSION's status under mechanism FIRST_ISSUE, because there is no attempt for it to be the status of.",[520,521],"The certificate version being proved.",[268,303],[268,303],"The durable handle for the probe, named operationId because that is what every other deferred write in this API calls its handle. Always equal to activationId. It is NOT a row in the document operation collection — a probe issues no comprobante of the tenant's — so it does not resolve through GET /api/v2/operations/{id}; statusPath is where it is read. NULL when mechanism is FIRST_ISSUE: nothing durable was started, so there is nothing to poll, and publishing a handle that will never move on its own is worse than publishing none.",[568,569],"WHICH of the two activations was started, and it is the field to branch on before reading anything else. PROBE is BETA: an attempt is recorded and this API is about to sign a factura on the reserved series F000 and send it to SUNAT beta, so there is a verdict coming and statusPath is where it lands. FIRST_ISSUE is PRODUCTION: nothing was sent and nothing will be. The version is armed, it signs from this response onwards, and the FIRST comprobante you issue that SUNAT accepts or observes promotes it to ACTIVE in the same transaction that records that CDR. Production works this way because proving a certificate means having SUNAT accept a document signed with it, and in production such a document is a real comprobante in the taxpayer's registro de ventas, withdrawn only by an accepted comunicación de baja. Issuing one to prove a key is not this platform's decision to make; issuing the one you were going to issue anyway is not a decision at all.","PROBE","FIRST_ISSUE",[273],[251,253,575],{"_251":573,"_253":574,"_575":576},{"_7":268,"_271":579},{"_7":268,"_269":270},"certificates",{"_7":265,"_266":577},{"_452":578},"#/components/schemas/CertificateVersion",[273],[251,253,532,468,445,471,369,589,591,593,595,597,599,601,603,605,607,478,610,612,614,616,542],{"_251":582,"_253":583,"_532":584,"_468":585,"_445":586,"_471":587,"_369":588,"_589":590,"_591":592,"_593":594,"_595":596,"_597":598,"_599":600,"_601":602,"_603":604,"_605":606,"_607":608,"_478":609,"_610":611,"_612":613,"_614":615,"_616":617,"_542":618},{"_7":268,"_271":638},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":333,"_334":447},{"_7":268,"_271":637},{"_7":268,"_271":636},"certificateId",{"_7":268,"_269":270},"sha256",{"_7":268,"_309":635},"serialNumber",{"_7":268,"_632":634},"issuerName",{"_7":268,"_632":633},"subjectRuc",{"_7":268,"_309":394},"notBefore",{"_7":268,"_269":305},"notAfter",{"_7":268,"_269":305},"currentlyValid",{"_7":307},"revokedAt",{"_7":631,"_269":305},"validationMethod",{"_7":268,"_271":627},{"_7":268,"_269":305},"activatedAt",{"_7":626,"_269":305},"retiredAt",{"_7":625,"_269":305},"activation",{"_620":621},"activationPath",{"_7":268},{"_7":307,"_271":619},[23],"anyOf",[622,623],{"_452":624},{"_7":303},"#/components/schemas/CertificateVersionActivation",[268,303],[268,303],[628,629,630],"BETA_AUTHENTICATED","PRODUCTION_AUTHENTICATED","OPERATOR_ATTESTED",[268,303],"maxLength",500,200,"^[0-9a-f]{64}$",[509,510,388,511],[520,521],[273],[251,253,532,468,589,445,471,369,591,593,595,597,599,601,655,607,478,616,542],{"_251":641,"_253":642,"_532":643,"_468":644,"_589":645,"_445":646,"_471":647,"_369":648,"_591":649,"_593":650,"_595":651,"_597":652,"_599":653,"_601":654,"_655":656,"_607":657,"_478":658,"_616":659,"_542":660},{"_7":268,"_271":668},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":333,"_334":447},{"_7":268,"_271":667},{"_7":268,"_271":665,"_11":666},{"_7":268,"_309":635},{"_7":268,"_632":634},{"_7":268,"_632":633},{"_7":268,"_309":394},{"_7":268,"_269":305},{"_7":268,"_269":305},"rsaBits",{"_7":333,"_334":335},{"_7":268,"_271":664},{"_7":268,"_269":305},{"_7":268,"_11":663},{"_7":307,"_271":661,"_11":662},[246],"Always false on 201. A replayed key answers 200 instead.","The request that would make this version the one that signs.",[628,629,630],[509],"Always DRAFT. Enrolment never changes what signs.",[520,521],[273],[466,369,489,491,493,676,480],{"_466":671,"_369":672,"_489":673,"_491":674,"_493":675,"_676":677,"_480":678},{"_7":268,"_269":270},{"_7":268,"_271":683},{"_7":682},{"_7":681},{"_7":680},"requestedAt",{"_7":268,"_269":305},{"_7":679,"_269":305},[268,303],[268,303],[268,303],[268,303],[383,514,515,516,517,518],[468,445,471,369,589,591,593,595,597,599,601,603,605,607,478,610,612,614],{"_468":686,"_445":687,"_471":688,"_369":689,"_589":690,"_591":691,"_593":692,"_595":693,"_597":694,"_599":695,"_601":696,"_603":697,"_605":698,"_607":699,"_478":700,"_610":701,"_612":702,"_614":703},{"_7":268,"_269":270,"_11":717},{"_7":333,"_334":447},{"_7":268,"_271":716},{"_7":268,"_271":714,"_11":715},{"_7":268,"_269":270},{"_7":268,"_309":635,"_11":713},{"_7":268,"_632":634},{"_7":268,"_632":633},{"_7":268,"_309":394},{"_7":268,"_269":305},{"_7":268,"_269":305},{"_7":307,"_11":712},{"_7":711,"_269":305},{"_7":268,"_271":710},{"_7":268,"_269":305},{"_7":709,"_269":305},{"_7":708,"_269":305},{"_11":704,"_620":705},"The latest activation attempt on this version, or null if none was ever requested.",[706,707],{"_452":624},{"_7":303},[268,303],[268,303],[628,629,630],[268,303],"Whether this version could sign right now: inside its validity window and not revoked.","SHA-256 of the certificate DER, the identity the signer pins.",[509,510,388,511],"DRAFT signs nothing. PENDING_FIRST_ISSUE signs everything and is not proved yet: a PRODUCTION version armed through POST /api/v2/certificates/{id}/activation, which the next comprobante SUNAT accepts or observes promotes to ACTIVE. A company can hold at most one version that is ACTIVE or PENDING_FIRST_ISSUE per environment, so the two never compete and an ACTIVE version is never displaced by a newly enrolled one. ACTIVE is what the signing boundary resolves. RETIRED was replaced by a later activation, or was armed and refused by SUNAT for a reason attributable to the certificate; either way it is kept because documents pinned to it must stay verifiable — read activatedAt to tell the two apart, because only the first has one.",[520,521],"The enrolled version. This is the id POST /api/v2/certificates/{id}/activation takes.",[471,721,723,725,727],{"_471":720,"_721":722,"_723":724,"_725":726,"_727":728,"_607":729},{"_7":268,"_271":743,"_11":744},"pfxBase64",{"_7":268,"_732":739,"_632":740,"_309":741,"_11":742},"pfxPassword",{"_7":268,"_732":447,"_632":737,"_11":738},"solUser",{"_7":268,"_732":447,"_632":735,"_309":734,"_11":736},"solPassword",{"_7":268,"_732":447,"_632":733,"_309":734},{"_7":268,"_271":730,"_11":731},[628,629,630],"How the SOL credentials were verified. Defaults to OPERATOR_ATTESTED for BETA. A PRODUCTION account requires PRODUCTION_AUTHENTICATED.","minLength",128,"^[!-~]+$",64,"SUNAT SOL secondary user. Required together with the certificate: the certificate signs the XML and this authenticates sendBill.",256,"The password that opens the PKCS#12. Verified during this request.",4,700000,"^[A-Za-z0-9+/]+={0,2}$","The PKCS#12 (.pfx/.p12) file, standard base64. Never stored in plaintext, never logged, never returned.",[520,521],"Must be the environment this company is enrolled for; a mismatch is refused with CERTIFICATE_REJECTED and reason ENVIRONMENT_MISMATCH.",[251,253,417,750,542],{"_251":747,"_253":748,"_417":749,"_750":751,"_752":753,"_542":754},{"_7":268,"_271":758},{"_7":268,"_269":270},{"_7":268,"_269":270},"secretVersion",{"_7":333,"_334":757},"secret",{"_7":268,"_309":755,"_11":756},{"_7":307},"^[A-Za-z0-9_-]{43}$","Present only when replay is false.",2,[273],[251,253,417,764],{"_251":761,"_253":762,"_417":763,"_764":765},{"_7":268,"_271":767},{"_7":268,"_269":270},{"_7":268,"_269":270},"deleted",{"_7":307,"_271":766},[23],[273],[251,253,772],{"_251":770,"_253":771,"_772":773},{"_7":268,"_271":776},{"_7":268,"_269":270},"subscriptions",{"_7":265,"_266":774},{"_452":775},"#/components/schemas/WebhookSubscription",[273],"allOf",[779,780],{"_452":785},{"_7":244,"_247":781,"_249":782},[752],{"_752":783},{"_7":268,"_309":755,"_11":784},"HMAC-SHA256 signing key, 32 random bytes in base64url. Returned only in this response and never retrievable afterwards.","#/components/schemas/WebhookSubscriptionResponse",[787,788],{"_452":775},{"_7":244,"_247":789,"_249":790},[251,253],{"_251":791,"_253":792,"_532":793,"_542":794},{"_7":268,"_271":795},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":307},[273],[417,799,801,369,11,750,478,807],{"_417":798,"_799":800,"_801":802,"_369":803,"_11":804,"_750":805,"_478":806,"_807":808},{"_7":268,"_269":270},"url",{"_452":814},"events",{"_7":265,"_812":447,"_266":813},{"_7":268,"_271":810},{"_7":809,"_632":634},{"_7":333,"_334":447},{"_7":268,"_269":305},"updatedAt",{"_7":268,"_269":305},[268,303],[388,811],"PAUSED","minItems",{"_452":459},"#/components/schemas/WebhookDestination","minProperties",{"_799":817,"_801":818,"_369":819,"_11":820},{"_452":814},{"_7":265,"_812":447,"_823":824,"_266":825},{"_7":268,"_271":822},{"_7":821,"_732":447,"_632":634},[268,303],[388,811],"maxItems",8,{"_452":459},[799,801],{"_799":828,"_801":829,"_11":830},{"_452":814},{"_7":265,"_812":447,"_823":824,"_266":831},{"_7":268,"_732":447,"_632":634},{"_452":459},"uri",12,2000,"https URL on the default port, without credentials or a fragment, whose host is a public DNS name. IP literals in any notation, localhost, .local, .internal, .lan, .onion, in-addr.arpa and cloud metadata hosts are refused.","Versioned event catalog. Every entry is a transition the system already commits; document.ambiguous is separate from document.failed on purpose, because an ambiguous SUNAT submission may have arrived and must never be retried by the receiver.",[838,839,840,841,842,843,844,845],"document.accepted","document.ambiguous","document.failed","document.observed","document.pdf_ready","document.rejected","document.submitted","document.validated","Where a comprobante stands as a fiscal fact, on an axis independent of DocumentState. DocumentState answers \"did the submission reach SUNAT and what did SUNAT say\"; this answers \"does this comprobante still exist\". The normal end state of a successful comunicación de baja is state ACCEPTED with fiscalState VOIDED — the factura was accepted, and then it was withdrawn. ISSUED: nothing has reported or withdrawn it. REPORTED: carried by a resumen diario SUNAT accepted, with catalog 19 status 1 or 2. VOID_REQUESTED: named in a baja that is in flight, or in one whose outcome is unknown because the dispatch ended AMBIGUOUS — it is not a promise that the comprobante will be voided. VOIDED: named in a comunicación de baja SUNAT accepted, or in a resumen diario line with catalog 19 status 3 that SUNAT accepted.",[848,849,850,851],"ISSUED","REPORTED","VOID_REQUESTED","VOIDED",[853,854,855,856,857,858,859,860,861,516,862,863,517,864],"RECEIVED","VALIDATED","XML_BUILT","SIGNED","SUBMISSION_PENDING","SUBMITTED","TICKET_PENDING","ACCEPTED","OBSERVED","FAILED_RETRYABLE","FAILED_FINAL","CANCELLED",[443,369,869,871,591,874],{"_443":867,"_369":868,"_869":870,"_871":872,"_591":873,"_874":875},{"_7":268,"_271":884},{"_7":268,"_271":882},"mediaType",{"_7":268,"_271":877},"byteSize",{"_7":333,"_334":335},{"_7":268,"_309":635},"readyAt",{"_7":876,"_269":305},[268,303],[878,879,880,881],"application/xml","application/zip","application/pdf","image/png",[383,883,518],"READY",[885,886,887,888,449,450,889],"signed-xml","submission-zip","cdr-zip","cdr-xml","qr-png",[441,443,445,369,896,898],{"_441":892,"_443":893,"_445":894,"_369":895,"_896":897,"_898":899,"_869":900,"_871":901,"_591":902,"_874":903,"_904":905},{"_7":268,"_269":270},{"_7":268,"_271":921},{"_7":333,"_334":447,"_919":920},{"_7":268,"_271":917},"templateVersion",{"_7":268,"_271":914},"rendererVersion",{"_7":268,"_271":911},{"_7":268,"_271":910},{"_7":909,"_334":335},{"_7":908,"_309":635},{"_7":907,"_269":305},"downloadPath",{"_7":906},[268,303],[268,303],[268,303],[333,303],[880],[912,913],"browser-run-a4-v1","browser-run-ticket-v1",[915,916],"invoice-a4-v2","invoice-ticket-v1",[383,918,883,518],"RUNNING","maximum",2147483647,[449,450],[251,253,427,532,435,369,542,931],{"_251":924,"_253":925,"_427":926,"_532":927,"_435":928,"_369":929,"_542":930,"_931":932},{"_7":268,"_271":937},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_452":453},{"_7":268,"_271":935},{"_7":307},"representations",{"_7":265,"_812":447,"_823":757,"_266":933},{"_452":934},"#/components/schemas/PdfRepresentationMetadata",[383,918,936,518],"SUCCEEDED",[273],[251,941],{"_251":940,"_941":942},{"_7":268,"_271":960},"outputs",{"_7":265,"_812":447,"_823":757,"_266":943},{"_944":945},"oneOf",[946,947],{"_7":244,"_245":246,"_247":954,"_249":955},{"_7":244,"_245":246,"_247":948,"_249":949},[443,896],{"_443":950,"_896":951},{"_7":268,"_271":953},{"_7":268,"_271":952},[916],[450],[443,896],{"_443":956,"_896":957},{"_7":268,"_271":959},{"_7":268,"_271":958},[915],[449],[273],[251,253,425,966,931,969],{"_251":963,"_253":964,"_425":965,"_966":967,"_931":968,"_969":970},{"_7":268,"_271":982},{"_7":268,"_269":270},{"_7":268,"_269":270},"artifacts",{"_7":265,"_266":980},{"_7":265,"_823":978,"_266":979},"representationPage",{"_7":244,"_245":246,"_247":971,"_249":972},[973,975],{"_973":974,"_975":976},"limit",{"_7":333,"_334":447,"_919":978},"nextCursor",{"_7":977},[268,303],100,{"_452":934},{"_452":981},"#/components/schemas/ArtifactMetadata",[273],[251,253,425,966,931],{"_251":985,"_253":986,"_425":987,"_966":988,"_931":989},{"_7":268,"_271":992},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":265,"_266":991},{"_7":265,"_266":990},{"_452":934},{"_452":981},[273],[251,253,427,999,532,1002,369,1005,480],{"_251":995,"_253":996,"_427":997,"_425":998,"_999":1000,"_532":1001,"_1002":1003,"_369":1004,"_1005":1006,"_480":1007},{"_7":268,"_271":1024},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_269":270,"_11":1023},"resourceKind",{"_7":268,"_271":1017,"_11":1018},{"_7":268,"_269":270,"_11":1016},"operationType",{"_7":268,"_271":1010},{"_7":268,"_271":1009},"startedAt",{"_7":268,"_269":305},{"_7":1008,"_269":305},[268,303],[383,918,936,518],[1011,1012,1013,1014,1015],"CREATE_DOCUMENT_V2","SUBMIT_DOCUMENT_V2","GENERATE_PDF_V2","SUBMIT_SUMMARY_V2","SUBMIT_PAYMENT_REGIME_V2","The resource the operation acts on, in the collection named by resourceKind.",[18,1019,1020,1021,1022],"Which collection owns resourceId, and therefore where the result is read: document -> /api/v2/documents/{id}, summary -> /api/v2/summaries/{id}, voided -> /api/v2/voided/{id}, retention -> /api/v2/retentions/{id}, perception -> /api/v2/perceptions/{id}.","summary","voided","retention","perception","The comprobante this operation acts on. Present if and only if resourceKind is document, where it repeats resourceId; absent for every other kind, because a summary, void communication, retention or perception is not a row in the document collection.",[273],[1027,1029,1031,1033,1035],{"_1027":1028,"_1029":1030,"_1031":1032,"_1033":1034,"_1035":1036},"severity",{"_7":268,"_271":1054,"_11":1055},"standing",{"_7":268,"_271":1049,"_11":1050},"action",{"_7":268,"_271":1040,"_11":1041},"guidance",{"_7":268,"_11":1039},"catalogVersion",{"_7":1037,"_11":1038},[268,303],"Version of the SUNAT response catalog that produced this classification, recorded per attempt so an old verdict stays auditable. Always the version stored on the attempt, never the one the running service holds: reporting today's catalog for yesterday's verdict would forge the audit trail. Null, and present, when the attempt was finalized before migration 000048 added the column — the version was not recorded, and inventing one is the fabrication that migration refuses.","One sentence of human-readable guidance, derived from `action`.",[1042,1043,1044,1045,1046,1047,1048],"What the integrator should do next.","NONE","REVIEW_OBSERVATION","FIX_AND_REISSUE","FIX_AND_RESUBMIT","RETRY_LATER","FIX_CREDENTIALS","RECONCILE_DO_NOT_RESEND",[1051,1052,1053],"Whether the comprobante exists fiscally at SUNAT. MAY_BE_REGISTERED means it must never be sent again without reconciling first.","REGISTERED","NOT_REGISTERED","MAY_BE_REGISTERED",[860,1056,1057,1058,384],"Which class SUNAT's programmer manual puts the code in. OBSERVATION means the comprobante was ACCEPTED and registered, with warnings.","OBSERVATION","REJECTION","EXCEPTION",[251,253,425,471,429,431,433,435,1069,439,478,807],{"_251":1061,"_253":1062,"_425":1063,"_471":1064,"_429":1065,"_431":1066,"_433":1067,"_435":1068,"_1069":1070,"_439":1071,"_478":1072,"_807":1073,"_489":1074,"_491":1075,"_1076":1077},{"_7":268,"_271":1090},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_271":1089},{"_7":268,"_271":1088},{"_7":268},{"_7":268},{"_452":453},"fiscalState",{"_452":1087},{"_7":333,"_334":447},{"_7":268,"_269":305},{"_7":268,"_269":305},{"_7":1085,"_11":1086},{"_7":1083,"_11":1084},"sunat",{"_11":1078,"_620":1079},"Classification of `responseCode` by the versioned SUNAT response catalog. Null until SUNAT has answered. It classifies the CDR `cbc:ResponseCode` and nothing else, which is why an observed comprobante reports severity ACCEPTED here rather than OBSERVATION: SUNAT answers an observed document with ResponseCode `0` and carries the observations as `cbc:Note` entries, and `state` is the field that reports OBSERVED. Read `state` for whether there were observations and this block for what to do about the code.",[1080,1081],{"_452":1082},{"_7":303},"#/components/schemas/SunatResponseGuidance",[268,303],"SUNAT CDR `cbc:Description`, verbatim.",[268,303],"SUNAT CDR `cbc:ResponseCode`. `0` is an acceptance; anything else is the rejection code. Null until SUNAT has answered.","#/components/schemas/DocumentFiscalState",[455,456,457,458],[520,521],[273],[251,253,1095,1097],{"_251":1093,"_253":1094,"_1095":1096,"_1097":1098,"_1099":1100},{"_7":268,"_271":1106},{"_7":268,"_269":270},"valid",{"_7":307,"_11":1105},"findings",{"_7":265,"_11":1102,"_266":1103},"totals",{"_452":1101},"#/components/schemas/DocumentTotals","Empty when valid. Otherwise in the order the create route evaluates them: findings[0] is the one it would answer with, and the rest are the problems it would only have reported on the attempt after that.",{"_452":1104},"#/components/schemas/ValidationFinding","True exactly when findings is empty, which is exactly when POST /api/v2/documents would answer 200 or 201 for this body and this credential.",[273],[317,1110,1112,1114,1116,1118,1120,1122,1124,1126,1128,1130,1132,1134,1136],{"_317":1109,"_1110":1111,"_1112":1113,"_1114":1115,"_1116":1117,"_1118":1119,"_1120":1121,"_1122":1123,"_1124":1125,"_1126":1127,"_1128":1129,"_1130":1131,"_1132":1133,"_1134":1135,"_1136":1137,"_1138":1139,"_1140":1141},{"_7":268},"taxableAmount",{"_7":268},"exemptAmount",{"_7":268},"unaffectedAmount",{"_7":268},"exportAmount",{"_7":268},"freeAmount",{"_7":268,"_11":1173},"freeIgvAmount",{"_7":268,"_11":1172},"lineExtensionAmount",{"_7":268},"igvAmount",{"_7":268,"_11":1171},"icbperAmount",{"_7":268},"taxAmount",{"_7":268,"_11":1170},"taxInclusiveAmount",{"_7":268},"allowanceTotalAmount",{"_7":268},"chargeTotalAmount",{"_7":268},"payableAmount",{"_7":268,"_11":1169},"detraction",{"_7":244,"_245":246,"_247":1158,"_11":1159,"_249":1160},"credit",{"_7":244,"_245":246,"_247":1142,"_11":1143,"_249":1144},[1145,1147],"Present only on a Credito sale. pendingAmount is what is financed — payableAmount, or the detraction's netPayableAmount under the SPOT — and the instalments settle exactly it.",{"_1145":1146,"_1147":1148},"pendingAmount",{"_7":268},"installments",{"_7":265,"_266":1149},{"_7":244,"_245":246,"_247":1150,"_249":1151},[468,1153,1155],{"_468":1152,"_1153":1154,"_1155":1156},{"_7":268,"_11":1157},"amount",{"_7":268},"dueDate",{"_7":268,"_269":343},"Cuota001, Cuota002, ... Derived from the schedule order and never supplied; it reaches the XML, so it is published here.",[259,1162,1164,1153,1167],"Present only when the operation is subject to the SPOT. The split never reduces payableAmount: amount is what the acquirer deposits at the Banco de la Nacion and netPayableAmount is what reaches the supplier.",{"_259":1161,"_1162":1163,"_1164":1165,"_1153":1166,"_1167":1168},{"_7":268},"percent",{"_7":268},"baseAmount",{"_7":268},{"_7":268},"netPayableAmount",{"_7":268},"cbc:PayableAmount, the printed total and the QR IMPORTE_TOTAL.","igvAmount + icbperAmount.","The QR IGV_TOTAL.","IGV of the free operations. Reported, never payable.","Referential value of the free operations (scheme 9996).",[259,369,261],{"_259":1176,"_369":1177,"_261":1178,"_263":1179},{"_7":268,"_11":1182},{"_7":333,"_11":1181},{"_7":268},{"_7":265,"_266":1180},{"_7":244,"_245":23},"The HTTP status POST /api/v2/documents would answer with.","The error.code POST /api/v2/documents would answer with, verbatim: INVALID_DOCUMENT, DOCUMENT_ARITHMETIC_INVALID, SUPPLIER_RUC_MISMATCH, NOTE_CREATION_DISABLED, IDEMPOTENCY_CONFLICT, AFFECTED_DOCUMENT_NOT_FOUND, AFFECTED_DOCUMENT_NOT_ELIGIBLE, AFFECTED_DOCUMENT_MISMATCH, AFFECTED_DOCUMENT_ALREADY_CANCELLED, AFFECTED_FACTURA_CREDIT_EXCEEDED or AFFECTED_BOLETA_CREDIT_EXCEEDED.",[251,253,427,532,435,542],{"_251":1185,"_253":1186,"_427":1187,"_532":1188,"_435":1189,"_542":1190},{"_7":268,"_271":1191},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_452":453},{"_7":307},[273],"The CRE/CPE state machine. Deliberately not DocumentState: a CRE has no RECEIVED or CANCELLED. TICKET_PENDING is reachable only if SUNAT's 'otros CPE' service answers with a ticket instead of a CDR — ADR 0012 assumption 9 says it does not, and that assumption is not corroborated, so the state is published rather than hidden. AMBIGUOUS means an envelope may have reached SUNAT and no CDR came back; it is never redispatched automatically.",[854,855,856,857,858,859,860,861,516,862,863,517],[251,253,1198,427,429,471,431,433,1205,1207,1209,1211,1213,1215,1217,1219,1221,435,439,489,491,1227,1229,478,807],{"_251":1196,"_253":1197,"_1198":1199,"_427":1200,"_429":1201,"_471":1202,"_431":1203,"_433":1204,"_1205":1206,"_1207":1208,"_1209":1210,"_1211":1212,"_1213":1214,"_1215":1216,"_1217":1218,"_1219":1220,"_1221":1222,"_435":1223,"_439":1224,"_489":1225,"_491":1226,"_1227":1228,"_1229":1230,"_478":1231,"_807":1232},{"_7":268,"_271":1255},{"_7":268,"_269":270},"paymentRegimeId",{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_271":1252},{"_7":268,"_271":1251},{"_7":268,"_309":1250},{"_7":268,"_309":1249},"issueDate",{"_7":268,"_269":343},"documentName",{"_7":268,"_309":1248},"regimeCode",{"_7":268,"_309":1247},"regimePercent",{"_7":268},"agentRuc",{"_7":268,"_309":1246},"receiverRuc",{"_7":268,"_309":1246},"totalRegimeAmount",{"_7":268,"_11":1245},"totalNetAmount",{"_7":268,"_11":1244},"submissionProfileVersion",{"_7":268,"_271":1241},{"_452":1240},{"_7":333,"_334":447},{"_7":1238,"_11":1239},{"_7":1237},"errorCode",{"_7":1235,"_11":1236},"references",{"_7":265,"_812":447,"_266":1233},{"_7":268,"_269":305},{"_7":268,"_269":305},{"_452":1234},"#/components/schemas/PaymentRegimeReference",[268,303],"Set instead of responseCode when the attempt settled without a CDR, which is always an AMBIGUOUS outcome once the dispatch fence exists.",[268,303],[268,303],"SUNAT's response code, read from the CDR. Never present without the CDR digest that backs it: a fiscal verdict without a CDR is refused by a CHECK constraint, not merely avoided in code.","#/components/schemas/PaymentRegimeState",[1242,1243],"sunat-retention-cre-v1","sunat-perception-cpe-v1","sac:SUNATTotalPaid / sac:SUNATTotalCashed. ASSUMPTION: the sum of the per-reference NET amounts, not the gross of the payments.","cbc:TotalInvoiceAmount of the header: the sum of the regime amounts.","^\\d{11}$","^\\d{2}$","^[0-9]{11}-(20|40)-[RP][A-Z0-9]{3}-[0-9]{1,8}$","^\\d{1,8}$","^[RP][A-Z0-9]{3}$",[520,521],[1253,1254],"20","40",[273],[1259,1261,1263,1265,1267,1269,1271,1273,1275,1277,1279,1281,1283,1164,1286,1288],"One sac:SUNAT{Retention,Perception}DocumentReference as stored. baseAmount, regimeAmount and netAmount are always PEN and always derived; paidAmount stays in the referenced document currency.",{"_1259":1260,"_1261":1262,"_1263":1264,"_1265":1266,"_1267":1268,"_1269":1270,"_1271":1272,"_1273":1274,"_1275":1276,"_1277":1278,"_1279":1280,"_1281":1282,"_1283":1284,"_1164":1285,"_1286":1287,"_1288":1289},"referenceIndex",{"_7":333,"_334":447},"referenceDocumentType",{"_7":268,"_271":1295},"referenceSeries",{"_7":268,"_309":1294},"referenceNumber",{"_7":268,"_309":1249},"referenceIssueDate",{"_7":268,"_269":343},"referenceCurrency",{"_7":268,"_309":346},"referenceTotalAmount",{"_7":268},"paymentId",{"_7":268,"_309":1293},"paidAmount",{"_7":268},"paymentDate",{"_7":268,"_269":343},"regimeDate",{"_7":268,"_269":343},"exchangeRate",{"_7":1292},"exchangeDate",{"_7":1291,"_269":343},{"_7":268,"_11":1290},"regimeAmount",{"_7":268},"netAmount",{"_7":268},"The payment converted to PEN and rounded to the cent BEFORE the rate is applied. ASSUMPTION, recorded as a database constraint so a contradiction fails loudly.",[268,303],[268,303],"^\\d{1,9}$","^[FB][A-Z0-9]{3}$",[455,456,458],[251,253,427,532,429,1207,435,542],{"_251":1298,"_253":1299,"_427":1300,"_532":1301,"_429":1302,"_1207":1303,"_435":1304,"_542":1305},{"_7":268,"_271":1309},{"_7":268,"_269":270},{"_7":268,"_269":270,"_11":1308},{"_7":268,"_269":270},{"_7":268,"_271":1307},{"_7":268,"_309":1248,"_11":1306},{"_452":1240},{"_7":307},"The SUNAT submission name. It is also the ZIP entry base name and the CDR entry base name; SUNAT rejects a name that disagrees with the document it carries with error 1049.",[1253,1254],"Allocated at creation and reserved as the durable dispatch handle, so the handle returned here is the handle a future dispatch will run under.",[273],[251,429,431,433,1205,317,1209,1211,1324,1326,1328],{"_251":1312,"_429":1313,"_431":1314,"_433":1315,"_1205":1316,"_1317":1318,"_317":1319,"_1209":1320,"_1211":1321,"_1322":1323,"_1324":1325,"_1326":1327,"_1328":1329},{"_7":268,"_271":1342},{"_7":268,"_271":1341},{"_7":268,"_309":1340},{"_7":268,"_309":1249},{"_7":268,"_269":343},"issueTime",{"_7":268,"_1338":1339},{"_7":268,"_271":1336},{"_7":268,"_309":1247,"_11":1335},{"_7":268,"_309":1334},"note",{"_7":268,"_732":447,"_632":1333},"agent",{"_452":1332},"receiver",{"_452":1332},"documents",{"_7":265,"_812":447,"_823":633,"_266":1330},{"_452":1331},"#/components/schemas/PerceptionDocumentReference","#/components/schemas/PaymentRegimeParty",250,"^(?:100(?:\\.0{1,2})?|\\d{1,2}(?:\\.\\d{1,2})?)$","Catalog 22, cross-checked by SUNAT against the rate (error 2603).",[1337],"PEN","default","00:00:00","^P[A-Z0-9]{3}$",[1254],[1343],"1.0",[251,429,431,433,1205,317,1209,1211,1324,1326,1328],{"_251":1346,"_429":1347,"_431":1348,"_433":1349,"_1205":1350,"_1317":1351,"_317":1352,"_1209":1353,"_1211":1354,"_1322":1355,"_1324":1356,"_1326":1357,"_1328":1358},{"_7":268,"_271":1366},{"_7":268,"_271":1365},{"_7":268,"_309":1364},{"_7":268,"_309":1249},{"_7":268,"_269":343},{"_7":268,"_1338":1339},{"_7":268,"_271":1362,"_11":1363},{"_7":268,"_309":1247,"_11":1361},{"_7":268,"_309":1334},{"_7":268,"_732":447,"_632":1333},{"_452":1332},{"_452":1332},{"_7":265,"_812":447,"_823":633,"_266":1359},{"_452":1360},"#/components/schemas/RetentionDocumentReference","Catalog 23. The code/rate pair is NOT cross-checked locally: SUNAT checks it server-side (error 2619) and a rate table baked into this build would reject legitimate documents the day a resolución moves one.",[1337],"Both regimes settle in PEN only; SUNAT rejects any other currency on the header totals.","^R[A-Z0-9]{3}$",[1253],[1343],[429,431,433,1205,1373,1376,1279],{"_429":1369,"_431":1370,"_433":1371,"_1205":1372,"_1373":1374,"_317":1375,"_1376":1377,"_1279":1378,"_1281":1379},{"_7":268,"_271":1383,"_11":1384},{"_7":268,"_309":1294},{"_7":268,"_309":1249},{"_7":268,"_269":343},"totalAmount",{"_7":268,"_309":1382},{"_7":268,"_309":346,"_1338":1337},"payment",{"_452":1381},{"_7":268,"_269":343},{"_452":1380},"#/components/schemas/PaymentRegimeExchangeRate","#/components/schemas/PaymentRegimePayment","^(?:0|[1-9]\\d{0,11})(?:\\.\\d{1,2})?$",[455,456,458],"A perception may reference a boleta, because it reaches a customer who need not hold a RUC on the referenced sale. A retention may not.",[429,431,433,1205,1373,1376,1279],{"_429":1387,"_431":1388,"_433":1389,"_1205":1390,"_1373":1391,"_317":1392,"_1376":1393,"_1279":1394,"_1281":1395},{"_7":268,"_271":1397,"_11":1398},{"_7":268,"_309":1396},{"_7":268,"_309":1249},{"_7":268,"_269":343},{"_7":268,"_309":1382},{"_7":268,"_309":346,"_1338":1337},{"_452":1381},{"_7":268,"_269":343},{"_452":1380},"^F[A-Z0-9]{3}$",[455,458],"SUNAT's XSL also accepts 12, 07 and 20. They are outside this profile: a credit note makes the payment and retention blocks optional, which is a different arithmetic shape with no official example to pin it.",[1402,1406,343],"Required exactly when the referenced document is not PEN, and rejected when it is: every regime amount is PEN, so a foreign-currency payment needs the rate that takes it there.",{"_1402":1403,"_1404":1405,"_1406":1407,"_343":1408},"sourceCurrency",{"_7":268,"_309":346},"targetCurrency",{"_7":268,"_271":1410,"_1338":1337},"rate",{"_7":268,"_309":1409},{"_7":268,"_269":343},"^(?:0|[1-9]\\d{0,3})(?:\\.\\d{1,6})?$",[1337],[468,1153,343],"cac:Payment of a referenced document: the instalment being settled. The XSD allows at most ONE payment per reference, so a document paid in instalments is declared as several references sharing the same series/number and differing in this id.",{"_468":1414,"_1153":1415,"_343":1416},{"_7":268,"_309":1293},{"_7":268,"_309":1382,"_11":1417},{"_7":268,"_269":343},"Amount paid or collected, in the currency of the referenced document. ASSUMPTION: this, and not the referenced total, is the base the regime rate applies to.",[429,1422,367],"cac:AgentParty and cac:ReceiverParty. Both are always RUC holders (schemeID 6). The agent is the issuer of the document; the receiver is the supplier being withheld from (CRE) or the customer being charged (CPE). Deliberately not named supplier/customer: in a retention the receiver is the supplier, and forcing the invoice vocabulary here would produce a supplier that is sometimes the issuer and sometimes not.",{"_429":1421,"_1422":1423,"_367":1424,"_1425":1426,"_1427":1428,"_1429":1430,"_1431":1432,"_1433":1434,"_1435":1436,"_1437":1438,"_1439":1440},{"_7":268,"_271":1449},"documentNumber",{"_7":268,"_309":1246},{"_7":268,"_732":447,"_632":978},"tradeName",{"_7":268,"_732":447,"_632":978},"countryCode",{"_7":268,"_271":1447,"_1338":1448},"ubigeo",{"_7":268,"_309":1446},"address",{"_7":268,"_732":447,"_632":978},"district",{"_7":268,"_732":447,"_632":1444},"province",{"_7":268,"_732":447,"_632":1444,"_11":1445},"department",{"_7":268,"_732":447,"_632":1444},"establishmentCode",{"_7":268,"_309":1441,"_1338":1442,"_11":1443},"^\\d{4}$","0000","Inherited from the shared party schema. Neither the Retention nor the Perception root has a slot for it, so it is accepted and never emitted.",30,"ASSUMPTION: cbc:CityName, per SUNAT's own XSL comments. A widely used PHP implementation maps province and department the other way round; both are optional and SUNAT flags neither, so the divergence is invisible to validation.","^\\d{6}$",[1448],"PE",[1450],"6","The RC/RA state machine. It is deliberately not DocumentState: a summary has no RECEIVED or CANCELLED, and TICKET_PENDING is the state it spends most of its life in.",[854,855,856,857,858,859,860,861,516,862,863,517],[1456,1458,1460],"How many of this communication's lines name a comprobante this API holds. `unlinked` is not an error count: a line naming a comprobante issued through another provider, on paper under a contingency authorisation, or before this tenant integrated, is valid and is accepted. What it means is that no local guarantee covers it — an unlinked line takes no claim, so a second baja over the same comprobante cannot be detected here and SUNAT's ERROR 2323 is the only thing behind it.",{"_1456":1457,"_1458":1459,"_1460":1461},"total",{"_7":333,"_334":335,"_919":633},"linked",{"_7":333,"_334":335,"_919":633},"unlinked",{"_7":333,"_334":335,"_919":633},[251,253,1466,427,1469,471,1205,1473,1475,1207,1221,435,439,1481,1483,1485,489,491,1227,1229,478,807],{"_251":1464,"_253":1465,"_1466":1467,"_427":1468,"_1469":1470,"_471":1471,"_1205":1472,"_1473":1474,"_1475":1476,"_1207":1477,"_1221":1478,"_435":1479,"_439":1480,"_1481":1482,"_1483":1484,"_1485":1486,"_489":1487,"_491":1488,"_1227":1489,"_1229":1490,"_1491":1492,"_478":1493,"_807":1494},{"_7":268,"_271":1513},{"_7":268,"_269":270},"summaryId",{"_7":268,"_269":270},{"_7":268,"_269":270},"summaryType",{"_7":268,"_271":1510},{"_7":268,"_271":1509},{"_7":268,"_269":343},"referenceDate",{"_7":268,"_269":343},"correlative",{"_7":268,"_309":1508},{"_7":268,"_309":1507},{"_7":268,"_271":1504},{"_452":1503},{"_7":333,"_334":447},"lineCount",{"_7":333,"_334":447,"_919":633},"ticket",{"_7":1501,"_11":1502},"lastStatusCode",{"_7":1500},{"_7":1499},{"_7":1498},{"_7":1497},{"_452":1496},"deadline",{"_452":1495},{"_7":268,"_269":305},{"_7":268,"_269":305},"#/components/schemas/VoidedDeadline","#/components/schemas/SummaryReferenceCounts",[268,303],[268,303],[268,303],[268,303],[268,303],"The SUNAT ticket. It is the only handle getStatus accepts, so it is published for out-of-band reconciliation of an AMBIGUOUS dispatch.","#/components/schemas/SummaryState",[1505,1506],"sunat-summary-rc-v1","sunat-voided-ra-v1","^[0-9]{11}-R[CA]-[0-9]{8}-[0-9]{1,5}$","^\\d{1,5}$",[520,521],[1511,1512],"RC","RA",[273],[251,253,427,532,1469,1207,435,542],{"_251":1516,"_253":1517,"_427":1518,"_532":1519,"_1469":1520,"_1207":1521,"_435":1522,"_542":1523,"_1491":1524},{"_7":268,"_271":1527},{"_7":268,"_269":270},{"_7":268,"_269":270,"_11":1526},{"_7":268,"_269":270},{"_7":268,"_271":1525},{"_7":268,"_309":1507},{"_452":1503},{"_7":307},{"_452":1495},[1511,1512],"Also the durable Workflow instance id, so the handle returned by create is the handle the dispatch runs under.",[273],[369,1532,1534],"Reported for both families and never enforced, but for two different reasons. For a comunicación de baja the window is seven calendar days from the day after the affected comprobante was issued (workbook sheet `Control de Cambios` row 399, which also records that SUNAT delegated the check to the OSE) and SUNAT rejects a late one outright with ERROR 2957; it is still only reported, because a one-day disagreement about the window would destroy a remedy SUNAT would have honoured. For a resumen diario SUNAT merely OBSERVES lateness — OBSERVACIÓN 4443, and an observed document is an accepted document — so a late RC is a valid RC; the limit of seven days is an assumption, since the workbook keys the window as parameter `004: Plazo máximo de envío` and publishes no value for it. EXPIRED on a summary whose lines are all catalog 19 status 1 or 2 is a warning; on one carrying a status 3 it predicts an outright rejection, because annulling late is ERROR 2957 there too.",{"_369":1531,"_1532":1533,"_1534":1535},{"_7":268,"_271":1536},"elapsedDays",{"_7":333},"limitDays",{"_7":333,"_334":335},[1537,1538,1539],"WITHIN_DEADLINE","EXPIRED","INVALID_ORDER",[251,429,1205,1473,1475,1547,1549],{"_251":1542,"_429":1543,"_1205":1544,"_1473":1545,"_1475":1546,"_1547":1548,"_1549":1550},{"_7":268,"_271":1557},{"_7":268,"_271":1556},{"_7":268,"_269":343,"_11":1555},{"_7":268,"_269":343,"_11":1554},{"_7":268,"_309":1508},"supplier",{"_452":1553},"lines",{"_7":265,"_812":447,"_823":633,"_266":1551},{"_452":1552},"#/components/schemas/VoidedLine","#/components/schemas/SummaryIssuer","cbc:ReferenceDate: the issue date of the documents being withdrawn. It cannot be after issueDate.","cbc:IssueDate: the day the void is communicated.",[1512],[1343],[251,429,1205,1473,1475,1547,1549],{"_251":1560,"_429":1561,"_1205":1562,"_1473":1563,"_1475":1564,"_1547":1565,"_1549":1566},{"_7":268,"_271":1573},{"_7":268,"_271":1572},{"_7":268,"_269":343,"_11":1571},{"_7":268,"_269":343,"_11":1570},{"_7":268,"_309":1508,"_11":1569},{"_452":1553},{"_7":265,"_812":447,"_823":633,"_266":1567},{"_452":1568},"#/components/schemas/SummaryLine","N of RUC-RC-YYYYMMDD-N, greater than zero and unique per issuer, environment, type and issue date.","cbc:ReferenceDate: the day the summarized documents were issued. It cannot be after issueDate.","cbc:IssueDate: the day the summary is generated and communicated.",[1511],[1343],[429,431,433,1579],{"_429":1576,"_431":1577,"_433":1578,"_1579":1580},{"_7":268,"_271":1582,"_11":1583},{"_7":268,"_309":1396},{"_7":268,"_309":1249},"reason",{"_7":268,"_732":447,"_632":978,"_11":1581},"cbc:VoidReasonDescription. Free text; SUNAT requires a reason.",[455,457,458],"03 is deliberately absent. A boleta is annulled by a daily summary line with statusCode 3; an RA over a boleta is rejected by SUNAT while leaving the operator believing it was withdrawn.",[429,431,433,1589,317,1373,1597],{"_429":1586,"_431":1587,"_433":1588,"_1589":1590,"_317":1591,"_1592":1593,"_1373":1594,"_1595":1596,"_1597":1598,"_1599":1600},{"_7":268,"_271":1617},{"_7":268,"_309":1615,"_11":1616},{"_7":268,"_309":1249},"statusCode",{"_7":268,"_271":1610,"_11":1611},{"_7":268,"_271":1609},"customer",{"_452":1608},{"_452":1607},"payments",{"_452":1606},"taxes",{"_452":1605},"affectedDocument",{"_777":1601,"_11":1602},[1603],"Required on a 07 or 08 line and rejected on a 03 line: only a summarized note references a document.",{"_452":1604},"#/components/schemas/SummaryAffectedDocument","#/components/schemas/SummaryTaxes","#/components/schemas/SummaryBillingPayments","#/components/schemas/SummaryAmount","#/components/schemas/SummaryCustomer",[1337],[1612,1613,1614],"Catalog 19. 1 add, 2 modify, 3 annul. A boleta is annulled with 3 here, never with a void communication.","1","2","3","^B[A-Z0-9]{3}$","Everything reported in an RC is boleta-family, including the notes that affect a boleta, so every series starts with B.",[456,457,458],[429,431,433],"The boleta a summarized note affects. Only 03 may be affected inside an RC; a note over a factura belongs to sendBill.",{"_429":1621,"_431":1622,"_433":1623},{"_7":268,"_271":1624},{"_7":268,"_309":1615},{"_7":268,"_309":1249},[456],"sac:BillingPayment breakdown: taxable (01), exempt (02), unaffected (03) and free (05). A zero or absent bucket is omitted, because SUNAT reads the presence of a bucket as 'this operation type occurred'.",{"_1627":1628,"_1629":1630,"_1631":1632,"_1633":1634},"taxable",{"_452":1607},"exempt",{"_452":1607},"unaffected",{"_452":1607},"free",{"_452":1607},[1638],"IGV is always declared, even at zero. The optional schemes are omitted from the UBL when absent.",{"_1638":1639,"_1640":1641,"_1642":1643,"_1644":1645},"igv",{"_452":1607},"isc",{"_452":1607},"icbper",{"_452":1607},"other",{"_452":1607},[429,1422],"Optional on purpose: a boleta below the identification threshold carries no customer, and requiring one here would make those days unsendable.",{"_429":1649,"_1422":1650},{"_7":268,"_309":1652},{"_7":268,"_309":1651},"^[0-9A-Za-z-]{1,15}$","^[0-9A-Z]$",[429,1422,367],{"_429":1655,"_1422":1656,"_367":1657,"_1425":1658},{"_7":268,"_271":1660},{"_7":268,"_309":1246},{"_7":268,"_732":447,"_632":633,"_11":1659},{"_7":268,"_732":447,"_632":633},"No tab or line-break whitespace and no leading or trailing whitespace. Runtime also enforces XML 1.0 code points.",[1450],"^\\d{1,12}\\.\\d{2}$","A settled summary amount. Exactly two decimals, unlike the up-to-six-decimal unit values of an invoice line.","examples",[1665],"118.00",[1724,1725,1726,1727],[251,429,431,433,1205,317,1547,1592,1549],{"_251":1669,"_429":1670,"_431":1671,"_433":1672,"_1205":1673,"_1317":1674,"_317":1675,"_1002":1676,"_1677":1678,"_1147":1679,"_1680":1681,"_1599":1682,"_1547":1683,"_1592":1684,"_1549":1685,"_1686":1687,"_1138":1688},{"_7":268,"_271":1723},{"_7":268,"_271":1721,"_11":1722},{"_7":268,"_309":1719,"_11":1720},{"_7":268,"_309":1249},{"_7":268,"_269":343},{"_7":268,"_309":1718,"_1338":1339},{"_7":268,"_271":1716},{"_7":268,"_309":1441,"_1338":1714,"_11":1715},"paymentMethod",{"_7":268,"_271":1710,"_1338":1711,"_11":1712},{"_7":265,"_812":447,"_823":1706,"_266":1707,"_11":1708},"reasonCode",{"_7":268,"_271":1699,"_11":1700},{"_452":1698},{"_452":1697},{"_452":1696},{"_7":265,"_812":447,"_823":633,"_266":1694},"allowanceCharges",{"_7":265,"_823":1690,"_266":1691,"_11":1692},{"_452":1689},"#/components/schemas/Detraction",20,{"_452":1693},"Catalog 53 global allowances (03) and charges (50). Accepted on 01/03 only; the 07/08 note profiles reject them.","#/components/schemas/DocumentAllowanceCharge",{"_452":1695},"#/components/schemas/InvoiceLine","#/components/schemas/InvoiceCustomer","#/components/schemas/Supplier","#/components/schemas/AffectedInvoiceReference",[455,1701,456,1702,1703,1704,457,458,1705],"Reason for a 07 or 08 note, read from catalog 09 or catalog 10 respectively. The two catalogs overlap without agreeing: the value is only meaningful together with documentType, and the note profile above states which codes each type admits. On a 07 the code also decides whether the note voids the affected factura or credits part of it, which is the one place the value changes what the rest of the body has to contain.","02","04","05","06","09",999,{"_452":1709},"Schedule of a credit sale, in chronological order, on 01 or 03. The instalments must add up to the cent to what is left pending: the payable amount, or the amount net of the detraction when the operation is subject to the SPOT, because the deposit at the Banco de la Nacion is not owed to the supplier. A schedule that does not settle the pending amount is rejected. The 999 ceiling is what the CuotaNNN identifier can express, not a business quota. The 07/08 note profiles reject the field.","#/components/schemas/Installment",[1711,1713],"Contado","Credito requires the installments array and Contado forbids it; the two are the same fact stated twice.","Credito","0101","Catalog 51. 1001 (operation subject to the SPOT) and the detraction object must be declared together; any other value forbids detraction.",[1337,1717],"USD","^\\d{2}:\\d{2}:\\d{2}$","^[A-Z0-9]{4}$","The per-profile patterns above narrow this: F for a factura, B for a boleta, and either for a note depending on what it affects. Two values are refused on every document type: F000 and B000 are reserved for the platform and answer 422 INVALID_DOCUMENT. F000 is the series the certificate activation probe issues on, and SUNAT records that probe under this tenant's RUC even though it is not a document in this API, so a tenant-issued F000 would collide with a number SUNAT already holds.",[455,456,457,458],"01 requires F-series and a RUC customer, or a non-domiciled catalog 06 0/7 customer when every line is affectation 40 (export); 03 requires a B-series and a customer identified by catalog 06 1, 4, 7 or 0, or catalog 06 0 with documentNumber \"-\" for a PEN sale of at most 700.00 that identifies nobody; 07/08 are PEN and take the series and the customer of the comprobante they modify — F-series and a RUC over a factura, B-series and the boleta's own acquirer (sentinel included) over a boleta.",[1343],{"_9":1829,"_7":244,"_249":1830},{"_9":1810,"_7":244,"_1730":1811,"_249":1812},{"_9":1774,"_7":244,"_247":1775,"_1730":1776,"_249":1777},{"_9":1728,"_7":244,"_247":1729,"_1730":1731,"_249":1732},"Debit note profile",[1680,1599],"not",{"_620":1763},{"_429":1733,"_431":1734,"_317":1735,"_1680":1736,"_1599":1737,"_1549":1738,"_1547":1739,"_1592":1740},{"_7":268,"_271":1762},{"_7":268,"_309":1760,"_11":1761},{"_7":268,"_271":1758,"_11":1759},{"_7":268,"_271":1756,"_11":1757},{"_452":1698},{"_7":265,"_812":447,"_823":633,"_266":1754},{"_452":1753},{"_777":1741},[1742,1743],{"_452":1752},{"_7":244,"_11":1744,"_249":1745},"The acquirer of the comprobante the note modifies, and it must be that same acquirer. Over a factura that is a RUC (catalog 06 6, 11 digits) or, when every line is affectation 40 (export), a non-domiciled catalog 06 0 or 7 with a countryCode other than PE. Over a boleta it is whatever the boleta carried: catalog 06 1, 4, 7 or 0 — including 0 with documentNumber \"-\" when the boleta identified nobody, in which case the note must be PEN and its total may not exceed 700.00 (SUNAT 2514). An acquirer identified by a Peruvian document declares PE.",{"_429":1746,"_1422":1747},{"_7":268,"_271":1748},{"_7":268,"_309":1651},[1450,1749,1612,1750,1751],"0","4","7","#/components/schemas/NoteParty","#/components/schemas/NoteSupplier",{"_452":1755},"#/components/schemas/NoteLine",[455,1701,456],"Catalog 10. 01 late-payment interest, 02 increase in value, 03 penalties and other concepts. Catalog 10 has no 04 to 10; 11 and 12 need export or IVAP lines, and 13 does not take effect until 2027-01-01. The affected factura is always referenced, including on 03, which SUNAT lets omit it only until then.",[1337,1717],"The currency of the comprobante the note modifies, and it must be that same currency (SUNAT 3209). USD is therefore only reachable against a USD comprobante; the equality is checked against the stored payload, not here.","^[BF][A-Z0-9]{3}$","F when affectedDocument.documentType is 01, B when it is 03. SUNAT reads the affected type off this first character, so the two cannot disagree (errors 2400 and 2116). F000 and B000 are reserved for the platform and are refused with 422 INVALID_DOCUMENT here too: a note is a document like any other and the reservation is not narrowed for it.",[458],[1764,1765,1766,1767,1768],{"_247":1773},{"_247":1772},{"_247":1771},{"_247":1770},{"_247":1769},[1138],[1686],[1147],[1677],[1002],"Credit note profile",[1680,1599],{"_620":1799},{"_429":1778,"_431":1779,"_317":1780,"_1680":1781,"_1599":1782,"_1549":1783,"_1547":1784,"_1592":1785},{"_7":268,"_271":1798},{"_7":268,"_309":1760,"_11":1797},{"_7":268,"_271":1796,"_11":1759},{"_7":268,"_271":1794,"_11":1795},{"_452":1698},{"_7":265,"_812":447,"_823":633,"_266":1793},{"_452":1753},{"_777":1786},[1787,1788],{"_452":1752},{"_7":244,"_11":1744,"_249":1789},{"_429":1790,"_1422":1791},{"_7":268,"_271":1792},{"_7":268,"_309":1651},[1450,1749,1612,1750,1751],{"_452":1755},[455,1701,456,1702,1703,1704,457,458,1705],"Catalog 09, and what the code means for the note. 01 annulment, 02 annulment for a wrong RUC, 03 correction of the description and 06 full return void the affected comprobante: the note must reproduce its fiscal lines and totals (only line descriptions may differ), and exactly one such note may ever exist per comprobante. 04 global discount, 05 per-item discount, 07 per-item return, 08 bonus and 09 decrease in value credit part of it: the note carries its own lines and its own amounts, fewer lines if that is what happened, and any number of them may stand against one comprobante. What bounds them is the total: the credit accumulated by every 07 note may not exceed the affected comprobante's payable amount, and the note that would take it past is refused with 409 AFFECTED_FACTURA_CREDIT_EXCEEDED or 409 AFFECTED_BOLETA_CREDIT_EXCEEDED. Over a boleta, 04, 05 and 08 are refused: SUNAT observes them (4367) because a discount or bonification to a final consumer belongs on the boleta itself. The reasons that change the document itself (10, 11, 12, 13) are not accepted.",[1337,1717],"F when affectedDocument.documentType is 01, B when it is 03. SUNAT reads the affected type off this first character, so the two cannot disagree (errors 2399 and 2116). F000 and B000 are reserved for the platform and are refused with 422 INVALID_DOCUMENT here too: a note is a document like any other and the reservation is not narrowed for it.",[457],[1800,1801,1802,1803,1804],{"_247":1809},{"_247":1808},{"_247":1807},{"_247":1806},{"_247":1805},[1138],[1686],[1147],[1677],[1002],"Boleta profile",{"_620":1826},{"_429":1813,"_431":1814,"_1592":1815},{"_7":268,"_271":1825},{"_7":268,"_309":1615},{"_777":1816},[1817,1818],{"_452":1824},{"_7":244,"_11":1819,"_249":1820},"Catalog 06 1 (DNI, 8 digits), 4 (carne de extranjeria), 7 (passport) or 0 (non-domiciled document without RUC); never 6. For the ordinary retail sale that identifies nobody, send documentType 0 with documentNumber \"-\", which is the sentinel SUNAT's own boleta validation reads as \"no identity\". That form is accepted only while the document total stays at or below PEN 700.00 and only in PEN: above it, SUNAT rejects the daily summary that carries the boleta with error 2514.",{"_429":1821,"_1422":1822},{"_7":268,"_271":1823},{"_7":268,"_309":1651},[1749,1612,1750,1751],"#/components/schemas/Party",[456],[1827],{"_247":1828},[1138],"Factura profile",{"_429":1831,"_431":1832,"_1592":1833},{"_7":268,"_271":1834},{"_7":268,"_309":1396},{"_452":1696},[455],[429,431,433],[1843,1844],{"_429":1838,"_431":1839,"_433":1840},{"_7":268,"_271":1841,"_11":1842},{"_7":268,"_309":1760},{"_7":268,"_309":1249},[455,456],"The comprobante the note modifies. It has to agree with the note's own series: SUNAT reads the affected type off that first character and rejects the pair when they disagree (2399 for a B-series credit note that does not modify a boleta, 2400 for a B-series debit note, 2116 for an F-series note that does not modify a factura).",{"_9":1850,"_7":244,"_249":1851},{"_9":1845,"_7":244,"_249":1846},"Boleta affected",{"_429":1847,"_431":1848},{"_7":268,"_271":1849},{"_7":268,"_309":1615},[456],"Factura affected",{"_429":1852,"_431":1853},{"_7":268,"_271":1854},{"_7":268,"_309":1396},[455],[1856,1857],{"_452":1824},{"_7":244,"_247":1858,"_249":1859},[429,1422],{"_429":1860,"_1422":1861},{"_7":268,"_271":1863,"_11":1864},{"_7":268,"_309":1651,"_11":1862},"Shape depends on documentType: 11 digits for 6, 8 digits for 1, and this alphanumeric form for 0, 4 and 7, whose length and alphabet are set by the issuing state. The single character \"-\" is reserved: paired with documentType 0 on a boleta 03 it is SUNAT's marker for a sale that identifies nobody, and it is refused on a factura and with every other code.",[1749,1612,1750,1450,1751],"Catalog 06. 6 is a RUC (11 digits) and 1 a DNI (8 digits). On a factura 01 the customer is a RUC, or — only when every line is affectation 40 (export) — a non-domiciled 0 or 7 with a countryCode other than PE and no detraction. A boleta 03 accepts 1, 4 (carne de extranjeria), 7 (passport) and 0 (non-domiciled document without RUC), but never 6. 4 and 7 are refused on a factura because a resident foreigner needs a RUC to use its tax credit; on a boleta, which grants no credit, that reason does not apply.",[1153,1155],"One instalment (cuota) of a credit sale. The identifier is not accepted here: Cuota001, Cuota002 ... are derived from the order of the array, so a schedule can never publish duplicated, missing or out-of-order identifiers.",{"_1153":1868,"_1155":1869},{"_7":268,"_309":1871,"_11":1872,"_1663":1873},{"_7":268,"_269":343,"_11":1870},"Maturity of this instalment. It cannot precede the issue date, and the schedule cannot run backwards.","^(?:[1-9]\\d*\\.\\d{2}|0\\.(?:0[1-9]|[1-9]\\d))$","Amount of this instalment in the document currency, with exactly two decimals and greater than zero. Unlike a unit value this is a settled figure that has to add up to the cent.",[1874],"400.00",[259,1162,1880],"SPOT (detraccion). Redirects part of the payment to the supplier's Banco de la Nacion account and never reduces the declared total: PayableAmount, the printed total and the QR IMPORTE_TOTAL stay whole. Accepted on 01 in PEN only, and only together with operationType 1001. The S/ 700 floor is deliberately not enforced here: it varies by annex (transporte de carga uses S/ 400 and several services have no floor) and moves by resolucion, so applicability remains the issuer's responsibility.",{"_259":1878,"_1162":1879,"_1880":1881,"_1882":1883},{"_7":268,"_309":1884,"_11":1893},{"_7":268,"_309":1334,"_11":1890,"_1663":1891},"supplierAccount",{"_7":268,"_309":1246,"_11":1887,"_1663":1888},"paymentMeansCode",{"_7":268,"_309":1884,"_1338":1885,"_11":1886},"^\\d{3}$","001","Catalog 59 means of payment for the deposit; 001 is the deposit in account. The catalog is not vendored, so only the shape is validated.","The supplier's detraction account at the Banco de la Nacion, digits only; normalize the hyphenated form the bank prints.",[1889],"00065012345","Rate applied to the document total, greater than 0 and at most 100, e.g. 12 or 1.5. Supplied by the caller rather than derived from code: catalog 54 rates change by resolucion and a table baked into the service would reject legitimate invoices until upgraded. The deposit amount is derived from this rate and never supplied.",[1892],"12","Catalog 54 code of the good or service subject to the SPOT. The code list is not vendored, so only the shape is validated.","^(?:[1-9]\\d*(?:\\.\\d{1,6})?|0\\.(?:[1-9]\\d{0,5}|0[1-9]\\d{0,4}|00[1-9]\\d{0,3}|000[1-9]\\d{0,2}|0000[1-9]\\d?|00000[1-9]))$",[1612],"^(0|[1-9]\\d*)(\\.\\d{1,6})?$",[1898],"100.50",[1900,1901],{"_452":1695},{"_7":244,"_11":1902,"_1730":1903,"_249":1904},"A note line is a comprobante line with one structure removed and two text fields narrowed. Every catalog 07 affectation, the ICBPER excise and every catalog 03 unit are accepted here exactly as they are on 01/03, because SUNAT's note rules carry all three (NotaCredito2_0 rows 161, 290 and 384; ERROR 2936 outside catalog 03, ERROR 3003 for the exonerada/inafecta/exportacion header totals, ERROR 3306 for the ICBPER total). allowanceCharges is refused: SUNAT computes a note line as quantity x unit value with discounts and charges explicitly removed (ERROR 3271, OBSERVACION 4288 over a boleta), so a note that declared one would be rejected. A discount granted after the fact is expressed as the note's own lines under catalog 09 04, 05 or 08.",{"_620":1913},{"_1905":1906,"_11":1907},"productCode",{"_7":268,"_632":1444,"_309":1911,"_11":1912},{"_7":268,"_732":1908,"_632":633,"_309":1909,"_11":1910},3,"^\\S(?:[^\\t\\r\\n]*\\S)?$","No leading/trailing or control whitespace. Runtime also enforces XML 1.0 code points.","^(?:$|\\S(?:[^\\t\\r\\n]*\\S)?)$","Empty or free of leading/trailing and control whitespace. Runtime also enforces XML 1.0 code points. Narrower than the 100 characters a 01/03 line accepts, because 30 is the length SUNAT states for a note item code (OBSERVACION 4234).",[1914],{"_247":1915},[1686],[11,1920,1922,1924,1926],{"_1905":1918,"_11":1919,"_1920":1921,"_1922":1923,"_1924":1925,"_1926":1927,"_1928":1929,"_1930":1931,"_1686":1932},{"_7":268,"_632":978},{"_7":268,"_732":447,"_632":1961},"unitCode",{"_7":268,"_732":447,"_632":1908},"quantity",{"_452":1940},"unitValue",{"_452":1940},"affectationCode",{"_7":268,"_271":1945,"_11":1946},"igvRate",{"_7":268,"_777":1941,"_11":1942},"icbperUnitAmount",{"_7":268,"_777":1937,"_11":1938},{"_7":265,"_823":1933,"_266":1934,"_11":1935},10,{"_452":1936},"Catalog 53 line allowances (00) and charges (47).","#/components/schemas/LineAllowanceCharge",[1939],"ICBPER charged per unit (catalog 05 scheme 7152). Absent means no ICBPER; when present the quantity must be a whole number.",{"_452":1940},"#/components/schemas/PositiveDecimal",[1943],"Defaults to 18 for the taxed catalog 07 codes 10-16 and 0 for every other code; any other value is rejected.",{"_452":1944},"#/components/schemas/Decimal",[1947,1948,1892,1949,1950,1951,1952,1253,1953,1954,1955,1956,1957,1958,1959,1960,1254],"Catalog 07. 10/20/30/40 are the onerous profiles; 11-16, 21 and 31-36 are the free-of-charge (gratuita) profiles, which publish a referential value instead of a taxable base. 17 (IVAP) is not supported.","10","11","13","14","15","16","21","30","31","32","33","34","35","36",1000,[1965,1153],"Catalog 53 global allowance (03) or charge (50). Only the variants that do not change the IGV base are accepted; base-changing global adjustments (02/49) are not modelled.",{"_1965":1966,"_1680":1967,"_1153":1968},"chargeIndicator",{"_7":307,"_11":1972},{"_7":268,"_271":1969,"_11":1970},{"_452":1940},[456,1971],"Defaults to 03 for an allowance and 50 for a charge; any other pairing is rejected.","50","false is an allowance, true is a charge.",[1965,1153],"Catalog 53 line-level allowance (00) or charge (47). Both change the IGV base of the line they belong to and are rejected on a free operation.",{"_1965":1976,"_1680":1977,"_1153":1978},{"_7":307,"_11":1972},{"_7":268,"_271":1979,"_11":1980},{"_452":1940},[1981,1982],"Defaults to 00 for an allowance and 47 for a charge; any other pairing is rejected.","00","47",[1984,1985],{"_452":1752},{"_7":244,"_247":1986,"_249":1987},[429,1422],{"_429":1988,"_1422":1989,"_1427":1990},{"_7":268,"_271":1992},{"_7":268,"_309":1246},{"_7":268,"_271":1991,"_1338":1448},[1448],[1450],[1994,1995],{"_452":1824},{"_7":244,"_249":1996},{"_367":1997,"_1425":1998,"_1431":1999},{"_7":268,"_732":1908,"_632":633,"_309":1909,"_11":1910},{"_7":268,"_732":1908,"_632":633,"_309":1909,"_11":1910},{"_7":268,"_632":634,"_309":1911,"_11":2000},"Empty or free of leading/trailing and control whitespace. Runtime also enforces XML 1.0 code points.",[2002,2003],{"_452":1824},{"_7":244,"_247":2004,"_249":2005},[429,1422],{"_429":2006,"_1422":2007},{"_7":268,"_271":2008},{"_7":268,"_309":1246},[1450],[429,1422,367],{"_429":2011,"_1422":2012,"_367":2013,"_1425":2014,"_1427":2015,"_1429":2016,"_1431":2017,"_1433":2018,"_1435":2019,"_1437":2020,"_1439":2021},{"_7":268,"_309":2023},{"_7":268,"_309":1651},{"_7":268,"_732":447,"_632":633},{"_7":268,"_632":633},{"_7":268,"_309":2022,"_1338":1448},{"_7":268,"_309":1446},{"_7":268,"_632":633},{"_7":268,"_632":978},{"_7":268,"_632":978},{"_7":268,"_632":978},{"_7":268,"_309":1441,"_1338":1442},"^[A-Z]{2}$","^\\d{1,2}$",[2026],{"_2026":2027},"respuesta",{"_7":244,"_245":246,"_247":2028,"_249":2029},[2030,369,253,259,2035],{"_2030":2031,"_369":2032,"_253":2033,"_259":2034,"_2035":2036,"_263":2037},"success",{"_7":307,"_271":2041},{"_7":333,"_334":2039,"_919":2040},{"_7":268,"_269":270},{"_7":268},"mensaje",{"_7":268},{"_7":265,"_266":2038},{"_7":244},400,599,[246],[2026],{"_2026":2044},{"_7":244,"_245":246,"_247":2045,"_249":2046},[2030,369,253,427,425,435,2053,542,2035],{"_2030":2047,"_369":2048,"_253":2049,"_427":2050,"_425":2051,"_435":2052,"_2053":2054,"_542":2055,"_931":2056,"_2035":2057},{"_7":307,"_271":2063},{"_7":333,"_271":2060},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_452":453},"operationStatus",{"_7":268,"_271":2059},{"_7":307},{"_7":265,"_812":447,"_823":447,"_266":2058},{"_7":268},{"_452":934},[383,918,936,518],[634,2061,2062],201,202,[23],[2066],{"_2066":2067},"comprobante",{"_7":244,"_245":246,"_247":2068,"_249":2069,"_944":2070},[2074,2076,2085],{"_2074":2083,"_2076":2084,"_2085":2086},[2071,2072],{"_249":2079},{"_249":2073},{"_2074":2075,"_2076":2077},"tipoDoc",{"_7":268,"_271":2078},"serie",{"_7":268,"_309":1615},[456],{"_2074":2080,"_2076":2081},{"_7":268,"_271":2082},{"_7":268,"_309":1396},[455],{"_7":268,"_271":2087},{"_7":268,"_309":1294},"correlativo",{"_7":268,"_309":1249},[455,456],[2066,2095,266],{"_2066":2117,"_2095":2118,"_266":2119},[2091,2092],{"_249":2106},{"_249":2093},{"_2066":2094,"_2095":2096},{"_249":2103},"cliente",{"_249":2097},{"_2074":2098,"_2099":2100},{"_7":268,"_271":2102},"numDoc",{"_7":268,"_309":2101},"^\\d{8}$",[1612],{"_2074":2104},{"_7":268,"_271":2105},[456],{"_2066":2107,"_2095":2108},{"_249":2114},{"_249":2109},{"_2074":2110,"_2099":2111},{"_7":268,"_271":2113},{"_7":268,"_309":2112},"^(?:10|15|16|17|20)\\d{9}$",[1450],{"_2074":2115},{"_7":268,"_271":2116},[455],{"_7":244,"_245":246,"_247":2171,"_249":2172,"_944":2173},{"_7":244,"_245":246,"_247":2147,"_249":2148,"_944":2149},{"_7":265,"_812":447,"_823":633,"_266":2120},{"_7":244,"_245":246,"_247":2121,"_249":2122},[2125,2127,2129,2131,2133],{"_2123":2124,"_2125":2126,"_2127":2128,"_2129":2130,"_2131":2132,"_2133":2134,"_2135":2136},"codProducto",{"_7":268,"_732":447,"_632":978},"descripcion",{"_7":268,"_732":447,"_632":1961},"unidad",{"_7":268,"_271":2140},"cantidad",{"_7":268,"_309":1894},"mtoValorUnitario",{"_7":268,"_309":1894},"codeAfect",{"_7":268,"_271":2139},"igvPorcent",{"_7":268,"_271":2137,"_1338":2138},[2138],"18",[1947],[2141,2142,2143,2144,2145,2146],"NIU","KGM","LTR","MTR","HUR","ZZ",[2074,2099,2162],{"_2074":2160,"_2099":2161,"_2162":2163,"_2164":2165,"_2166":2167},[2150,2151],{"_249":2156},{"_249":2152},{"_2074":2153,"_2099":2154},{"_7":268,"_271":2155},{"_7":268,"_309":2101},[1612],{"_2074":2157,"_2099":2158},{"_7":268,"_271":2159},{"_7":268,"_309":2112},[1450],{"_7":268,"_271":2170},{"_7":268,"_309":2169},"rznSocial",{"_7":268,"_732":447,"_632":633},"codigoPais",{"_7":268,"_271":2168,"_1338":1448},"direccion",{"_7":268,"_732":447,"_632":633},[1448],"^\\d{8,11}$",[1612,1450],[2074,2076,2085,2189,2193],{"_2184":2185,"_2074":2186,"_2076":2187,"_2085":2188,"_2189":2190,"_2191":2192,"_2193":2194,"_2195":2196},[2174,2175],{"_249":2180},{"_249":2176},{"_2074":2177,"_2076":2178},{"_7":268,"_271":2179},{"_7":268,"_309":1615},[456],{"_2074":2181,"_2076":2182},{"_7":268,"_271":2183},{"_7":268,"_309":1396},[455],"tipoOperacion",{"_7":268,"_271":2201,"_1338":1714},{"_7":268,"_271":2200},{"_7":268,"_309":1294},{"_7":268,"_309":1249},"fechaEmision",{"_7":268,"_269":343},"horaEmision",{"_7":268,"_309":2199,"_1338":1339},"tipoMoneda",{"_7":268,"_271":2198},"tipoPago",{"_7":268,"_271":2197,"_1338":1711},[1711],[1337,1717],"^(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$",[455,456],[1714],[251,253,532,2207,2209,2211],{"_251":2204,"_253":2205,"_532":2206,"_2207":2208,"_2209":2210,"_2211":2212},{"_7":268,"_271":2217},{"_7":268,"_269":270},{"_7":268,"_269":270},"organizationId",{"_7":268,"_269":270},"company",{"_452":2216},"credentials",{"_7":265,"_266":2213,"_11":2214},{"_452":2215},"Every credential of this company, newest first, including any an operator or the console created. Empty is a legitimate answer for a company that has had none minted yet.","#/components/schemas/CompanyCredentialState","#/components/schemas/OrganizationCompanyState",[273],[251,253,2207,2223,2225],{"_251":2220,"_253":2221,"_2207":2222,"_2223":2224,"_2225":2226},{"_7":268,"_271":2234},{"_7":268,"_269":270},{"_7":268,"_269":270},"companies",{"_7":265,"_266":2233},"page",{"_7":244,"_245":246,"_247":2227,"_249":2228},[973,975],{"_973":2229,"_975":2230},{"_7":333,"_334":447,"_919":634},{"_7":2231,"_309":394,"_11":2232},[268,303],"Pass as ?cursor= to get the next page. Non-null exactly when this page came back full, which may also mean there were exactly this many: the last page of a full-sized set costs one further request that returns no companies.",{"_452":2216},[273],"A credential that can act as this company. THE TOKEN IS NOT HERE AND IS NOT BEING WITHHELD: it was returned exactly once by POST .../credentials and only its SHA-256 was ever stored, so no route can re-read it and none ever will. A lost token is replaced by minting another and revoking this one.",[2238,2240,2242,2244,2246,369,478,2250,605,2253],{"_2238":2239,"_2240":2241,"_2242":2243,"_2244":2245,"_2246":2247,"_369":2248,"_478":2249,"_2250":2251,"_605":2252,"_2253":2254},"credentialId",{"_7":268,"_269":270},"name",{"_7":2268},"tokenPrefix",{"_7":268,"_11":2267},"tokenFormat",{"_7":268,"_271":2263,"_11":2264},"scopes",{"_7":265,"_266":2261,"_11":2262},{"_7":268,"_271":2258,"_11":2259},{"_7":268,"_269":305},"expiresAt",{"_7":268,"_269":305},{"_7":2257,"_269":305},"lastUsedAt",{"_7":2255,"_269":305,"_11":2256},[268,303],"Recorded at most once a minute, so it is a liveness signal and not an access log. Null means this credential has never authenticated a request.",[268,303],[388,1538,2260],"Derived from revokedAt and expiresAt, in that order of precedence.","REVOKED",{"_7":268},"What this credential may do. companies:manage and organizations:read can never appear here: both are refused in storage by a CHECK on auth.api_credential_scopes, because a credential that can both issue comprobantes and administer the organization is the escalation ADR 0016 confines to the organization side.",[2265,2266],"LEGACY_HMAC_SHA256 marks a credential migrated from the v1 surface, which authenticates by a different path. They are listed because a credential nobody can see is a credential nobody retires.","V2_SHA256","LEGACY_HMAC_SHA256","The public selector, apf_v2__. It carries nothing credentialId does not -- it is derivable from it -- and is returned so that matching a credential in your own configuration against this row needs no string building.",[268,303],"The certificate block is ABSENT, not null, for a company that has never enrolled one -- which is every company between its registration and its first certificate upload, and is a different state from having one in some state.",[468,354,367,369,471,478,2278,2282,2284],{"_468":2272,"_354":2273,"_367":2274,"_369":2275,"_471":2276,"_478":2277,"_2278":2279,"_2280":2281,"_2282":2283,"_2284":2285},{"_7":268,"_269":270},{"_7":268,"_309":394},{"_7":268},{"_7":268,"_271":2291,"_11":2292},{"_7":268,"_271":2290},{"_7":268,"_269":305},"capabilities",{"_7":265,"_266":2287,"_11":2288},"certificate",{"_452":2286},"certificatePath",{"_7":268},"credentialsPath",{"_7":268},"#/components/schemas/CompanyCertificateState",{"_452":2289},"Every capability column of this company, sorted by name. An ARRAY and not an object of fixed keys, so a capability added by a later migration is reported rather than being a contract violation -- and so the entries match error.details[] on a capability rejection key for key.","#/components/schemas/CompanyCapabilityState",[520,521],[388,389],"Always ACTIVE on this surface. An INACTIVE company is not reported at all -- it is one of the three cases these routes deliberately cannot distinguish, along with a company of another organization and one that does not exist. The enum keeps both values because the underlying column has both and a client should not break the day that changes.","TWO VERSIONS ARE REPORTED, NOT ONE, because the two questions differ and either alone answers the other wrongly. 'active' is what signs today; 'latest' is the highest version enrolled, whatever became of it, and it is where a rejected upload shows up. When a company's v3 is ACTIVE and its v4 upload was refused, reporting only 'latest' would say the company cannot bill when it can, and reporting only 'active' would hide the refusal the caller is trying to debug. They are frequently the same version, which is the healthy case. 'active' IS ABSENT, not null, when there is none.",[2296,2300],{"_2296":2297,"_2298":2299,"_2300":2301},"readyToSign",{"_7":307,"_11":2303},"active",{"_452":2302},"latest",{"_452":2302},"#/components/schemas/CertificateVersionState","An ACTIVE version exists, its certificate is unrevoked, and now is inside its validity window. This is the CERTIFICATE half of 'can this client bill' and only that half -- the other half is capabilities, and neither implies the other, because the two are fixed by different people. A company with readyToSign true and submission_publication_enabled false will have its documents accepted and never dispatched.","One enrolled certificate version. Object keys, envelope descriptors and password references are deliberately absent: they are the internal layout of the signing boundary and no caller can act on them. The role serving this route holds column-level SELECT that excludes them outright, so their absence is a privilege rather than a habit.",[2307,445,369,478,610,612,593,2315,597,599,601,605],{"_2307":2308,"_445":2309,"_369":2310,"_478":2311,"_610":2312,"_612":2313,"_593":2314,"_2315":2316,"_597":2317,"_599":2318,"_601":2319,"_605":2320,"_614":2321},"configurationId",{"_7":268,"_269":270},{"_7":333,"_334":447},{"_7":268,"_271":2328},{"_7":268,"_269":305},{"_7":2327,"_269":305},{"_7":2326,"_269":305},{"_7":268},"issuer",{"_7":268},{"_7":268,"_309":394,"_11":2325},{"_7":268,"_269":305},{"_7":268,"_269":305,"_11":2324},{"_7":2323,"_269":305},{"_452":2322},"#/components/schemas/CertificateActivationState",[268,303],"When this certificate stops being usable. Nothing in this API renews it, and an expiry that passes unnoticed stops a client billing on an ordinary Tuesday, so this is the field to put a calendar reminder on.","The RUC the certificate was issued to. It must match the company's own RUC for anything to sign; a mismatch is refused at enrolment.",[268,303],[268,303],[509,510,388,511],"The newest activation probe against one enrolled certificate version. The PROPERTY IS ABSENT when the version was never probed -- OpenAPI 3.0 forbids a $ref with siblings, so a nullable reference is not expressible and an optional property is the idiomatic answer. Activation is the step that promotes a DRAFT to ACTIVE, and since migration 000052 the only route through it is a real signed factura that SUNAT beta accepted.",[466,369,489,491,493,1005,480],{"_466":2332,"_369":2333,"_489":2334,"_491":2335,"_493":2336,"_1005":2337,"_480":2338},{"_7":268,"_269":270},{"_7":268,"_271":2346,"_11":2347},{"_7":2344,"_11":2345},{"_7":2343},{"_7":2341,"_11":2342},{"_7":268,"_269":305},{"_7":2339,"_269":305,"_11":2340},[268,303],"Null exactly while the status is PENDING or PROBING.",[268,303],"Set instead of responseCode when the attempt settled without a CDR.",[268,303],[268,303],"SUNAT's own response code, present once a CDR has been read.",[383,514,515,516,517,518],"REJECTED means SUNAT answered and refused the probe: the certificate or the SOL credentials are not accepted for this RUC, and responseCode carries SUNAT's own code. AMBIGUOUS means the probe was sent and no verdict came back; it is TERMINAL on this version and never retried, because a second probe could be a second comprobante under the client's RUC. Both are states in which the company CANNOT bill, and both need a new enrolment rather than a retry.",[2350,2352],{"_2350":2351,"_2352":2353},"capability",{"_7":268,"_11":2355},"enabled",{"_7":307,"_11":2354},"EVERY ONE OF THESE DEFAULTS TO false. A newly registered company can create documents and can do very little else until an administrator enables what it needs; that is a deliberate posture and not an oversight, and this field is how you find out which ones are still off before sending a document rather than after.","The PostgreSQL column on core.companies that gates the act, by its own name. THIS IS THE SAME STRING a capability rejection puts in error.details[].requirement, so a 409 and this read use one vocabulary and need no mapping between them. The set is OPEN: it is derived from the company row rather than from a fixed list, so a capability added by a future migration appears here without a contract change. Today it is the nine that exist: boleta_submission_enabled, credit_note_submission_enabled, debit_note_submission_enabled, note_creation_enabled, perception_issuance_enabled, retention_issuance_enabled, submission_publication_enabled, summary_submission_enabled and voided_submission_enabled.",[251,253,2360,2207,2223],{"_251":2358,"_253":2359,"_2360":2361,"_2207":2362,"_2223":2363},{"_7":268,"_271":2367},{"_7":268,"_269":270},"metric",{"_7":268},{"_7":268,"_269":270},{"_7":265,"_266":2364,"_11":2365},{"_452":2366},"One entry per company in the organization, each against its OWN plan period. Billing is unchanged: the quota holder is still the company (ADR 0015), and this is a read.","#/components/schemas/OrganizationUsageEntry",[273],[2370,354,367,369,2375,2377,2379,2381,973,2384],{"_2370":2371,"_354":2372,"_367":2373,"_369":2374,"_2375":2376,"_2377":2378,"_2379":2380,"_2381":2382,"_973":2383,"_2384":2385},"companyId",{"_7":268,"_269":270},{"_7":268,"_309":394},{"_7":268},{"_7":268,"_271":2392},"planCode",{"_7":2391},"metered",{"_7":307,"_11":2390},"periodUnit",{"_7":268,"_271":2387},"periodStart",{"_7":268,"_269":343},{"_7":2386},"consumed",{"_7":333},[333,303],[2388,2389],"DAY","MONTH","false when nothing caps this company: no active subscription, or no plan limit for the metric.",[268,303],[388,389],[251,253,532,2238,2399,2370,2402,2246,2250,478,2407],{"_251":2395,"_253":2396,"_532":2397,"_2238":2398,"_2399":2400,"_2370":2401,"_2402":2403,"_2246":2404,"_2250":2405,"_478":2406,"_2407":2408},{"_7":268,"_271":2412},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_269":270},"token",{"_7":268,"_11":2411},{"_7":268,"_269":270},"companyRuc",{"_7":268,"_309":394},{"_7":265,"_266":2410},{"_7":268,"_269":305},{"_7":268,"_269":305},"auditEventId",{"_7":268,"_269":270,"_11":2409},"The ops.audit_events row this minting wrote. It is returned because minting a credential is a privilege escalation (ADR 0016 point 3) and the caller is entitled to the reference that records it. The credential and the event commit in one transaction: neither exists without the other.",{"_7":268},"The secret, returned EXACTLY ONCE and never recoverable. Only its SHA-256 is stored. There is no route that re-reads it; a lost token is replaced by minting another and revoking this one.",[273],[2240,2246],{"_2240":2415,"_2246":2416,"_2417":2418},{"_7":268,"_732":447,"_632":634},{"_7":265,"_812":447,"_823":2421,"_266":2422,"_11":2423},"expiresInDays",{"_7":333,"_334":447,"_919":2419,"_1338":2420},365,90,16,{"_7":268,"_271":2424},"Scopes for the COMPANY credential being minted. companies:manage is not among them and cannot be: it is refused by a CHECK on auth.api_credential_scopes, because a credential that can both issue comprobantes and mint credentials is the privilege escalation ADR 0016 confines to the organization side.",[2425,2426,2427,2428,2429,2430,2431,2432,2433,2434,2435,2436],"artifacts:read","certificates:manage","consultations:cpe","consultations:dni","consultations:read","documents:create","documents:pdf","documents:read","documents:submit","documents:validate","operations:read","webhooks:manage",[251,253,532,468,354,367,369,471,2207,478,2282,2284],{"_251":2439,"_253":2440,"_532":2441,"_468":2442,"_354":2443,"_367":2444,"_369":2445,"_471":2446,"_2207":2447,"_478":2448,"_2282":2449,"_2284":2450},{"_7":268,"_271":2454},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_269":270},{"_7":268,"_309":394},{"_7":268},{"_7":268,"_271":2453},{"_7":268,"_271":2452},{"_7":268,"_269":270},{"_7":268,"_269":305},{"_7":268,"_11":2451},{"_7":268},"Where to upload this company's certificate and SOL credentials. The company can sign nothing until that has happened and the resulting DRAFT has been activated against SUNAT.",[520,521],[388,389],[273],[354,367,471],{"_354":2457,"_367":2458,"_471":2459},{"_7":268,"_309":394,"_11":2463},{"_7":268,"_732":447,"_632":2462},{"_7":268,"_271":2460,"_11":2461},[520,521],"The SUNAT environment this company will be enrolled for.",300,"The taxpayer's RUC. Ownership is NOT verified here and does not need to be: the company can issue nothing until SUNAT accepts a comprobante signed with a certificate issued to this RUC. Registering a RUC does, however, reserve it platform-wide, and every registration is recorded in the organization's audit log.","bearerAuth",{"_7":2466,"_2467":2468,"_2469":2470,"_11":2471},"http","scheme","bearer","bearerFormat","Opaque API token","Tenant-bound, scoped and expiring Apifact credential. Migrated legacy credentials are accepted only on deprecated v1 writes and tenant-scoped v2 read, poll and download routes. Each operation names the single scope it requires in x-required-scope; the scope array of the security requirement itself is empty because OpenAPI 3.0 requires it to be for a non-oauth2 scheme.","/health",{"_26":5701},{"_26":5695},"/api/v1/invoice/create",{"_2932":5617},"/api/v1/invoice/send",{"_2932":5545},"/api/v1/invoice/a4",{"_2932":5474},"/api/v1/invoice/ticket",{"_2932":5392},"/api/v2/documents",{"_2932":5158},"/api/v2/documents/validations",{"_2932":5083},"/api/v2/documents/{id}",{"_26":5039},"/api/v2/documents/{id}/submissions",{"_2932":4981},"/api/v2/documents/{id}/pdfs",{"_2932":4901},"/api/v2/documents/{id}/artifacts",{"_26":4842},"/api/v2/documents/{id}/artifacts/{kind}",{"_26":4763},"/api/v2/documents/{id}/artifacts/versions/{representationId}/{kind}",{"_26":4702},"/api/v2/summaries",{"_2932":4607},"/api/v2/summaries/{id}",{"_26":4565},"/api/v2/summaries/{id}/submissions",{"_2932":4507},"/api/v2/voided",{"_2932":4423},"/api/v2/voided/{id}",{"_26":4378},"/api/v2/voided/{id}/submissions",{"_2932":4318},"/api/v2/retentions",{"_2932":4230},"/api/v2/retentions/{id}",{"_26":4187},"/api/v2/retentions/{id}/submissions",{"_2932":4129},"/api/v2/perceptions",{"_2932":4026},"/api/v2/perceptions/{id}",{"_26":3980},"/api/v2/perceptions/{id}/submissions",{"_2932":3915},"/api/v2/webhooks/subscriptions",{"_2932":3774,"_26":3775},"/api/v2/webhooks/subscriptions/{id}",{"_3631":3632,"_3633":3634},"/api/v2/webhooks/subscriptions/{id}/secret-rotations",{"_2932":3556},"/api/v2/certificates",{"_2932":3411,"_26":3412},"/api/v2/certificates/{id}/activation",{"_2932":3242,"_26":3243},"/api/v2/organizations/companies",{"_26":3109,"_2932":3110},"/api/v2/organizations/companies/{id}/certificate",{"_2932":3020},"/api/v2/organizations/companies/{id}/credentials",{"_2932":2933},"/api/v2/organizations/usage",{"_26":2855},"/api/v2/organizations/companies/{id}",{"_26":2796},"/api/v2/consultations/ruc/{ruc}",{"_26":2745},"/api/v2/consultations/exchange-rate/{date}",{"_26":2686},"/api/v2/consultations/dni/{dni}",{"_26":2618},"/api/v2/operations/{id}",{"_26":2551},{"_29":2552,"_427":2553,"_1019":2554,"_11":2555,"_2556":2557,"_2558":2435,"_2559":2560,"_2561":2562},[2617],"getOperation","Get a tenant-owned v2 operation","Resolves any operationId this API has issued, from all five collections: documents, summaries (RC), voided communications (RA), retentions (20) and perceptions (40). resourceKind names the collection the result is read from and resourceId the resource inside it; documentId is present only for comprobantes. An operationId belonging to another tenant is indistinguishable from one that never existed: both answer 404 OPERATION_NOT_FOUND.","security",[2615],"x-required-scope","parameters",[2612],"responses",{"_2563":2564,"_2565":2566,"_2567":2568,"_2569":2570,"_2571":2572,"_2573":2574},"200",{"_11":2602,"_2603":2604,"_2576":2605},"401",{"_11":2575,"_2576":2599},"403",{"_11":2595,"_2576":2596},"404",{"_11":2575,"_2576":2592},"429",{"_11":2583,"_2576":2584},"500",{"_11":2575,"_2576":2577},"Stable error envelope","content",{"_2578":2579},"application/json",{"_2580":2581},"schema",{"_452":2582},"#/components/schemas/ErrorEnvelope","Request blocked by the edge rate limit",{"_2578":2585},{"_2580":2586},{"_7":244,"_245":246,"_247":2587,"_249":2588},[255],{"_255":2589},{"_7":268,"_271":2590},[2591],"rate_limit_exceeded",{"_2578":2593},{"_2580":2594},{"_452":2582},"Authenticated credential lacks operations:read",{"_2578":2597},{"_2580":2598},{"_452":2582},{"_2578":2600},{"_2580":2601},{"_452":2582},"Operation status","headers",{"_2609":2610},{"_2578":2606},{"_2580":2607},{"_452":2608},"#/components/schemas/OperationResponse","X-Request-Id",{"_2580":2611},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":2614},"in",{"_7":268,"_269":270},{"_2464":2616},[],"Operations",{"_29":2619,"_427":2620,"_1019":2621,"_11":2622,"_2556":2623,"_2558":2428,"_2559":2624,"_2561":2625},[2685],"consultDni","Resolve a DNI to a person's NAME — informational, never a validation","Answers what RENIEC's registry holds for an eight-digit DNI: the person's names, and nothing else. Informational like the two routes above — no create, no trigger and no dispatch decision resolves a DNI, so a boleta whose acquirer name was typed by hand is issued exactly as before while this route is answering 503.\n\nONLY THE NAME IS RETURNED, AND THAT IS A DECISION RATHER THAN A GAP. The directory this API calls also publishes a person's date of birth and gender, on a different endpoint. That endpoint is never called. Neither datum has a fiscal purpose in this product — a boleta needs at most the acquirer's name — and under Ley 29733's minimisation principle obtaining data with no purpose is the wrong default, not a feature waiting to be finished. Asking for them would be a change to this published contract, not a field somebody appends to a mapper. AND NOTHING IS STORED: not the name, not the DNI, and not a hash of the DNI. An eight-digit space is exhaustible in seconds, so a digest of a DNI identifies the person exactly as well as the DNI does and is not a de-identification of anything. What is recorded is one metered row per consultation carrying the tenant, the verdict CLASS and the instant, because the platform pays a third party for each call and an unattributable spend is one nobody can bill or cap. If you need the name later, keep it yourself, and keep `consultedAt` beside it — this surface has no cache and will not serve you the same answer twice.\n\nAN ABSENT ANSWER IS NOT AN ABSENT PERSON, and this is the expensive mistake the route is shaped to prevent. There are two answers and seven non-answers. `found: true` and `found: false` are both 200 and are both statements about the person: `false` means the registry was reached, answered, and holds no such record. Everything else is a 502 or a 503 with its own code and is a statement about the network or about this platform — never about the person. 502 DNI_DIRECTORY_AMBIGUOUS is the one to read twice: it means the directory answered 200 while declaring a failure WITHOUT saying which, so this API refuses to guess that the person does not exist. Treating any of the seven as `found: false` writes our outage into somebody's customer record and refuses a real person a real document. Branch on the STATUS CODE first and on `found` second.\n\nRequires consultations:dni, which is NOT consultations:read and is not implied by it. The padrón and exchange-rate routes read free local catalogues about legal entities; this one spends a platform contract, writes a row under row-level security and returns personal data about a natural person. A credential handed to a form so it can prefill a company's legal name must not thereby become a credential that can enumerate people's names.",[2683],[2680],{"_2563":2626,"_2565":2627,"_2567":2628,"_2629":2630,"_2571":2631,"_2573":2632,"_2633":2634,"_2635":2636},{"_11":2672,"_2603":2673,"_2576":2674},{"_11":2575,"_2576":2669},{"_11":2665,"_2576":2666},"422",{"_11":2661,"_2576":2662},{"_11":2583,"_2576":2654},{"_11":2575,"_2576":2651},"502",{"_11":2647,"_2576":2648},"503",{"_11":2637,"_2576":2638,"_2603":2639},"No answer was obtained at all, and again NONE of these is found=false. DNI_DIRECTORY_UNCONFIGURED: this deployment holds no directory key, so nothing was sent. DNI_DIRECTORY_UNAUTHORIZED: the directory refused THIS PLATFORM'S key — it is not about your credential, which is why it is not a 401, and rotating your token will not help. Both need an operator and therefore carry no Retry-After, because one would promise a recovery that never arrives on its own. DNI_DIRECTORY_THROTTLED: the directory is rate-limiting this platform, not you — it is not a 429 because 429 here means your own quota — and it carries Retry-After: 60. DNI_DIRECTORY_UNAVAILABLE: unreachable, timed out or 5xx, with Retry-After: 30. None of the four affects document issuance.",{"_2578":2645},{"_2640":2641},"Retry-After",{"_2580":2642,"_11":2643},{"_7":268,"_309":2644},"Seconds to wait. Present on DNI_DIRECTORY_THROTTLED and DNI_DIRECTORY_UNAVAILABLE only. Absent on DNI_DIRECTORY_UNCONFIGURED and DNI_DIRECTORY_UNAUTHORIZED, because both need an operator and no amount of waiting resolves them.","^[0-9]+$",{"_2580":2646},{"_452":2582},"The directory answered, and what it answered cannot be turned into a verdict about this person. NONE of these is found=false and none carries a Retry-After, because none is fixed by waiting. DNI_DIRECTORY_UNREADABLE: a 200 whose body this API cannot read as an identity. DNI_DIRECTORY_AMBIGUOUS: a 200 declaring a failure without saying which — the code that exists so an unrecognised negative is never guessed into 'this person does not exist'. DNI_DIRECTORY_REFUSED: the directory rejected the request for a reason about the request and not about the DNI, which is a bug on this side. None of the three affects document issuance.",{"_2578":2649},{"_2580":2650},{"_452":2582},{"_2578":2652},{"_2580":2653},{"_452":2582},{"_2578":2655},{"_2580":2656},{"_7":244,"_245":246,"_247":2657,"_249":2658},[255],{"_255":2659},{"_7":268,"_271":2660},[2591],"INVALID_DNI: the path segment is not exactly eight digits. Refused before the directory is called, so a malformed input never costs a paid request, and it is never reported as found=false. error.details is an ARRAY carrying the rejected candidate.",{"_2578":2663},{"_2580":2664},{"_452":2582},"INSUFFICIENT_SCOPE: the authenticated credential lacks consultations:dni. A credential holding only consultations:read receives this, deliberately. The WWW-Authenticate challenge names the scope to grant, and nothing is spent: no provider request and no metered row.",{"_2578":2667},{"_2580":2668},{"_452":2582},{"_2578":2670},{"_2580":2671},{"_452":2582},"The registry's answer. found=true and found=false are BOTH this status: a DNI the registry does not hold is a successful answer, not an error. The keys are the same either way, so branch on found and never on the response shape.",{"_2609":2678},{"_2578":2675},{"_2580":2676},{"_452":2677},"#/components/schemas/DniConsultationResponse",{"_2580":2679},{"_7":268,"_269":270},{"_2240":279,"_2613":27,"_247":23,"_2580":2681,"_11":2682},{"_7":268,"_309":310},"Exactly eight digits. Anything else is 422 INVALID_DNI, refused before a paid provider request is spent, and is never reported as a person who does not exist.",{"_2464":2684},[],"Consultations",{"_29":2687,"_427":2688,"_1019":2689,"_11":2690,"_2556":2691,"_2558":2429,"_2559":2692,"_2561":2693},[2685],"consultExchangeRate","Resolve the published exchange rate that applies on a given date","Returns the rate to apply to an operation on the requested date, following the rule in D.S. 29-94-EF artículo 5 numeral 17: the rate published on that date, or, on a day with no publication, EL ÚLTIMO PUBLICADO — the last one published on or before it. It never resolves forward and never interpolates. THE DATE IS A REQUIRED PATH SEGMENT WITH NO DEFAULT, on purpose: this service runs on UTC and Peru is UTC-05:00, so a server-side 'today' would resolve to tomorrow's date for every request sent after 19:00 in Lima, and the último-publicado rule would then hand back a rate labelled with a date the caller never asked about. The caller knows its comprobante's issue date; this service does not. BECAUSE THE ANSWER MAY COME FROM ANOTHER DAY, read rateDate, fallback and stalenessDays before displaying anything: fallback=true means rateDate differs from requestedOn, and stalenessDays is how far back the answer was taken from — 2 over a weekend is normal and correct under the rule, while 40 is not a market fact but a loader that stopped running. No ceiling is imposed here, because the norm has none; reporting is this API's half of the job and deciding is the caller's. Both sides are returned: for IGV the answer is sellRate ('promedio ponderado venta', for sales and purchases alike), while buyRate exists because the Impuesto a la Renta rule splits compra/venta by activo/pasivo. Rates are STRINGS with six decimals and must be parsed as decimals — routing a rate that gets multiplied into money through a binary float is the one place a fiscal figure can change value. Informational, like the padrón route: nothing here validates or blocks a document. Requires consultations:read.",[2743],[2734,2735],{"_2563":2694,"_2565":2695,"_2567":2696,"_2629":2697,"_2571":2698,"_2573":2699,"_2635":2700},{"_11":2726,"_2603":2727,"_2576":2728},{"_11":2575,"_2576":2723},{"_11":2719,"_2576":2720},{"_11":2715,"_2576":2716},{"_11":2583,"_2576":2708},{"_11":2575,"_2576":2705},{"_11":2701,"_2576":2702},"EXCHANGE_RATE_UNAVAILABLE: nothing has ever been published for this currency on or before the requested date — an unloaded currency, an empty series, or a date older than the first row loaded. Distinct from a resolved-but-stale answer, which is a 200 with fallback=true, and it does not affect document issuance.",{"_2578":2703},{"_2580":2704},{"_452":2582},{"_2578":2706},{"_2580":2707},{"_452":2582},{"_2578":2709},{"_2580":2710},{"_7":244,"_245":246,"_247":2711,"_249":2712},[255],{"_255":2713},{"_7":268,"_271":2714},[2591],"INVALID_RUC when the path segment is not exactly eleven digits, INVALID_DATE when it is not a real calendar date in YYYY-MM-DD (2026-02-30 is refused rather than rolled over to March), INVALID_CURRENCY when the currency query parameter is not three letters. A malformed input is refused before the catalogue is read, and is never reported as an absent taxpayer or a missing rate.",{"_2578":2717},{"_2580":2718},{"_452":2582},"Authenticated credential lacks consultations:read",{"_2578":2721},{"_2580":2722},{"_452":2582},{"_2578":2724},{"_2580":2725},{"_452":2582},"The applicable rate. rateDate may differ from requestedOn; when it does, fallback is true and stalenessDays says by how many days.",{"_2609":2732},{"_2578":2729},{"_2580":2730},{"_452":2731},"#/components/schemas/ExchangeRateConsultationResponse",{"_2580":2733},{"_7":268,"_269":270},{"_2240":343,"_2613":27,"_247":23,"_2580":2740,"_11":2741},{"_2240":317,"_2613":2736,"_247":246,"_2580":2737,"_11":2738},"query",{"_7":268,"_309":2739,"_1338":1717},"Three-letter code, case-insensitive and echoed back upper-cased. Defaults to USD, the only series loaded today. A currency with no loaded series answers 503 rather than falling back to USD.","^[A-Za-z]{3}$",{"_7":268,"_269":343,"_309":2742},"The date the rate is to APPLY to — normally the comprobante's issue date. A real calendar date in YYYY-MM-DD: 2026-02-30 is refused with 422 INVALID_DATE rather than rolled over to the 1st of March, which would attach a fiscal figure to a date nobody chose.","^\\d{4}-\\d{2}-\\d{2}$",{"_2464":2744},[],{"_29":2746,"_427":2747,"_1019":2748,"_11":2749,"_2556":2750,"_2558":2429,"_2559":2751,"_2561":2752},[2685],"consultTaxpayer","Look a RUC up in the hosted SUNAT padrón — informational, never a validation","Answers what SUNAT's published padrón says about a RUC: the legal name, the literal estado del contribuyente and condición de domicilio, and a coarse classification of each. THIS DOES NOT VALIDATE ANYTHING AND DOES NOT AFFECT ISSUANCE. A RUC this route reports as not registered can still be invoiced, and doing so is neither an error nor a warning: no create, no trigger and no dispatch decision reads this catalogue. The copy is a snapshot and is therefore ALWAYS behind — a company registered since the snapshot was cut is absent from it while being entirely able to receive a comprobante — so treat the answer as information for a human, not as a gate. THERE ARE THREE OUTCOMES AND ONLY TWO OF THEM ARE ABOUT THE TAXPAYER: 200 with registered=true, 200 with registered=false (a snapshot is loaded and this RUC is not in it), and 503 TAXPAYER_REGISTRY_UNAVAILABLE (no snapshot is loaded at all, which is a statement about this service). A client that folds the 503 into registered=false reports an outage of ours as a fact about somebody's customer. Both the literal SUNAT value and the classification are returned: the literal is authoritative and the classification is ours and may be UNKNOWN, so a value SUNAT adds tomorrow is visible rather than silently mapped. registry.publishedOn dates the snapshot the answer came from and is SUNAT's own publication date, never the time this API ingested it. Requires consultations:read, which is disjoint from every documents:* capability: asking who a RUC belongs to must not require a credential that can issue a comprobante.",[2794],[2791],{"_2563":2753,"_2565":2754,"_2567":2755,"_2629":2756,"_2571":2757,"_2573":2758,"_2635":2759},{"_11":2783,"_2603":2784,"_2576":2785},{"_11":2575,"_2576":2780},{"_11":2719,"_2576":2777},{"_11":2715,"_2576":2774},{"_11":2583,"_2576":2767},{"_11":2575,"_2576":2764},{"_11":2760,"_2576":2761},"TAXPAYER_REGISTRY_UNAVAILABLE: no padrón snapshot is loaded, so this API cannot answer the question at all. THIS IS NOT registered=false. It says nothing about the RUC, and it does not affect document issuance — a comprobante may be issued while this route is answering 503.",{"_2578":2762},{"_2580":2763},{"_452":2582},{"_2578":2765},{"_2580":2766},{"_452":2582},{"_2578":2768},{"_2580":2769},{"_7":244,"_245":246,"_247":2770,"_249":2771},[255],{"_255":2772},{"_7":268,"_271":2773},[2591],{"_2578":2775},{"_2580":2776},{"_452":2582},{"_2578":2778},{"_2580":2779},{"_452":2582},{"_2578":2781},{"_2580":2782},{"_452":2582},"The padrón's answer. registered=true and registered=false are BOTH this status: an unknown RUC is a successful answer, not an error.",{"_2609":2789},{"_2578":2786},{"_2580":2787},{"_452":2788},"#/components/schemas/TaxpayerConsultationResponse",{"_2580":2790},{"_7":268,"_269":270},{"_2240":354,"_2613":27,"_247":23,"_2580":2792,"_11":2793},{"_7":268,"_309":394},"Exactly eleven digits. Anything else is 422 INVALID_RUC and is never reported as an unregistered taxpayer.",{"_2464":2795},[],{"_29":2797,"_427":2798,"_1019":2799,"_11":2800,"_2556":2801,"_2558":2802,"_2559":2803,"_2561":2804},[2854],"getOrganizationCompany","Read one client company, its capabilities, its certificate and its credentials","Everything needed to answer 'can this client bill, and if not why not'. THE THREE FAILURES ARE ONE ANSWER: a company belonging to another organization, a company that does not exist and an INACTIVE company all return the identical 404, decided by a single SELECT rather than by three branches, so this route cannot be used to discover that a RUC is registered elsewhere. Requires organizations:read; a credential holding companies:manage satisfies it, and one holding only organizations:read can create nothing, mint nothing and enrol nothing.",[2852],"organizations:read",[2850],{"_2563":2805,"_2806":2807,"_2565":2808,"_2567":2809,"_2569":2810,"_2571":2811,"_2573":2812,"_2635":2813},{"_11":2842,"_2603":2843,"_2576":2844},"400",{"_11":2838,"_2576":2839},{"_11":2575,"_2576":2835},{"_11":2831,"_2576":2832},{"_11":2827,"_2576":2828},{"_11":2583,"_2576":2820},{"_11":2575,"_2576":2817},{"_11":2575,"_2576":2814},{"_2578":2815},{"_2580":2816},{"_452":2582},{"_2578":2818},{"_2580":2819},{"_452":2582},{"_2578":2821},{"_2580":2822},{"_7":244,"_245":246,"_247":2823,"_249":2824},[255],{"_255":2825},{"_7":268,"_271":2826},[2591],"ORGANIZATION_COMPANY_NOT_FOUND. Byte-identical, request id aside, for a company of another organization, a company that does not exist and an INACTIVE one.",{"_2578":2829},{"_2580":2830},{"_452":2582},"Authenticated credential lacks organizations:read, or is a company credential rather than an organization credential. A credential holding companies:manage satisfies organizations:read -- the implication runs that way and never the other.",{"_2578":2833},{"_2580":2834},{"_452":2582},{"_2578":2836},{"_2580":2837},{"_452":2582},"INVALID_PAGE_LIMIT when limit is not an integer in 1..200, or INVALID_PAGE_CURSOR when cursor is not an eleven-digit RUC.",{"_2578":2840},{"_2580":2841},{"_452":2582},"The company, its capability state, its certificate state and its credentials",{"_2609":2848},{"_2578":2845},{"_2580":2846},{"_452":2847},"#/components/schemas/OrganizationCompanyDetailResponse",{"_2580":2849},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":2851},{"_7":268,"_269":270},{"_2464":2853},[],"Organizations",{"_29":2856,"_427":2857,"_1019":2858,"_11":2859,"_2556":2860,"_2558":2802,"_2559":2861,"_2561":2862},[2854],"getOrganizationUsage","Consolidated consumption across every company in the organization","A read, and only a read. ADR 0016 point 6 keeps the quota holder on the company: a platform with fifty clients has fifty subscriptions and each taxpayer pays its own. usage.consume_quota is untouched. Each company is reported against its own plan period, so a mixed portfolio of DAY and MONTH plans is not flattened onto a window this route picked.",[2930],[2926],{"_2563":2863,"_2806":2864,"_2565":2865,"_2567":2866,"_2569":2867,"_2868":2869,"_2870":2871,"_2872":2873,"_2629":2874,"_2571":2875,"_2573":2876,"_2635":2877},{"_11":2918,"_2603":2919,"_2576":2920},{"_11":2575,"_2576":2915},{"_11":2575,"_2576":2912},{"_11":2908,"_2576":2909},{"_11":2904,"_2576":2905},"409",{"_11":2900,"_2576":2901},"413",{"_11":2575,"_2576":2897},"415",{"_11":2575,"_2576":2894},{"_11":2575,"_2576":2891},{"_11":2583,"_2576":2884},{"_11":2575,"_2576":2881},{"_11":2575,"_2576":2878},{"_2578":2879},{"_2580":2880},{"_452":2582},{"_2578":2882},{"_2580":2883},{"_452":2582},{"_2578":2885},{"_2580":2886},{"_7":244,"_245":246,"_247":2887,"_249":2888},[255],{"_255":2889},{"_7":268,"_271":2890},[2591],{"_2578":2892},{"_2580":2893},{"_452":2582},{"_2578":2895},{"_2580":2896},{"_452":2582},{"_2578":2898},{"_2580":2899},{"_452":2582},"COMPANY_RUC_TAKEN when the RUC is already registered, by this organization or any other. IDEMPOTENCY_CONFLICT when the key was reused with a different payload.",{"_2578":2902},{"_2580":2903},{"_452":2582},"ORGANIZATION_COMPANY_NOT_FOUND. A company belonging to another organization is reported identically to one that does not exist, so this route cannot be used to discover that a RUC is registered.",{"_2578":2906},{"_2580":2907},{"_452":2582},"Authenticated credential lacks companies:manage, or is a company credential rather than an organization credential. A company credential cannot reach these routes at all: it is refused by the token prefix before it is refused by the scope.",{"_2578":2910},{"_2580":2911},{"_452":2582},{"_2578":2913},{"_2580":2914},{"_452":2582},{"_2578":2916},{"_2580":2917},{"_452":2582},"Per-company consumption for the requested metric",{"_2609":2924},{"_2578":2921},{"_2580":2922},{"_452":2923},"#/components/schemas/OrganizationUsageResponse",{"_2580":2925},{"_7":268,"_269":270},{"_2240":2360,"_2613":2736,"_247":246,"_2580":2927},{"_7":268,"_632":2928,"_1338":2929},60,"documents.accepted",{"_2464":2931},[],"post",{"_29":2934,"_427":2935,"_1019":2936,"_11":2937,"_2556":2938,"_2558":2939,"_2559":2940,"_2941":2942,"_2561":2943},[2854],"mintCompanyCredential","Mint an API credential for a client company","Creates a COMPANY credential, which can issue comprobantes. ADR 0016 point 3 names this a privilege escalation and does not pretend otherwise: the mitigation is that it is recorded. The credential row and its ops.audit_events row are written in one transaction, and a DEFERRABLE constraint trigger on auth.api_credentials refuses at COMMIT to admit a credential for an organization-owned company without one -- so an unaudited mint is not a policy violation, it is a failed transaction. The token is returned exactly once.",[3018],"companies:manage",[3012,3013],"requestBody",{"_247":23,"_2576":3002},{"_2944":2945,"_2806":2946,"_2565":2947,"_2567":2948,"_2569":2949,"_2868":2950,"_2870":2951,"_2872":2952,"_2629":2953,"_2571":2954,"_2573":2955,"_2635":2956},"201",{"_11":2994,"_2603":2995,"_2576":2996},{"_11":2575,"_2576":2991},{"_11":2575,"_2576":2988},{"_11":2908,"_2576":2985},{"_11":2904,"_2576":2982},{"_11":2900,"_2576":2979},{"_11":2575,"_2576":2976},{"_11":2575,"_2576":2973},{"_11":2575,"_2576":2970},{"_11":2583,"_2576":2963},{"_11":2575,"_2576":2960},{"_11":2575,"_2576":2957},{"_2578":2958},{"_2580":2959},{"_452":2582},{"_2578":2961},{"_2580":2962},{"_452":2582},{"_2578":2964},{"_2580":2965},{"_7":244,"_245":246,"_247":2966,"_249":2967},[255],{"_255":2968},{"_7":268,"_271":2969},[2591],{"_2578":2971},{"_2580":2972},{"_452":2582},{"_2578":2974},{"_2580":2975},{"_452":2582},{"_2578":2977},{"_2580":2978},{"_452":2582},{"_2578":2980},{"_2580":2981},{"_452":2582},{"_2578":2983},{"_2580":2984},{"_452":2582},{"_2578":2986},{"_2580":2987},{"_452":2582},{"_2578":2989},{"_2580":2990},{"_452":2582},{"_2578":2992},{"_2580":2993},{"_452":2582},"Credential minted; the token is in this response and nowhere else",{"_2609":3000},{"_2578":2997},{"_2580":2998},{"_452":2999},"#/components/schemas/MintedCompanyCredentialResponse",{"_2580":3001},{"_7":268,"_269":270},{"_2578":3003},{"_2580":3004,"_1663":3005},{"_452":3011},{"_1338":3006},{"_3007":3008},"value",{"_2240":3009,"_2246":3010,"_2417":2420},"SaaS - facturacion 20698765432",[2430,2432,2433,2431,2435,2425,2436],"#/components/schemas/MintCompanyCredentialRequest",{"_2240":468,"_2613":27,"_247":23,"_2580":3017},{"_2240":3014,"_2613":3015,"_247":23,"_2580":3016},"Idempotency-Key","header",{"_7":268,"_732":447,"_632":634,"_309":734},{"_7":268,"_269":270},{"_2464":3019},[],{"_29":3021,"_427":3022,"_1019":3023,"_11":3024,"_2556":3025,"_2558":2939,"_2559":3026,"_2941":3027,"_2561":3028},[2854],"enrollOrganizationCompanyCertificate","Upload a client company's signing certificate and SOL credentials","The same body, the same validation, the same sealing boundary and the same DRAFT outcome as POST /api/v2/certificates -- it is that path, reached with the tenant established by auth.bind_organization_company after verifying the company belongs to the caller's organization. The PKCS#12 and the three passwords cross the signing service binding and reach nothing durable in between. Activation is deliberately NOT available here: promoting the DRAFT sends a real signed factura to SUNAT under the client's RUC, and that is performed with the company credential this organization minted.",[3107],[3103,3104],{"_247":23,"_2576":3092},{"_2563":3029,"_2944":3030,"_2806":3031,"_2565":3032,"_2567":3033,"_2569":3034,"_2868":3035,"_2870":3036,"_2872":3037,"_2629":3038,"_2571":3039,"_2573":3040,"_2635":3041},{"_11":3087,"_2576":3088},{"_11":3079,"_2603":3080,"_2576":3081},{"_11":2575,"_2576":3076},{"_11":2575,"_2576":3073},{"_11":2908,"_2576":3070},{"_11":2904,"_2576":3067},{"_11":2900,"_2576":3064},{"_11":2575,"_2576":3061},{"_11":2575,"_2576":3058},{"_11":2575,"_2576":3055},{"_11":2583,"_2576":3048},{"_11":2575,"_2576":3045},{"_11":2575,"_2576":3042},{"_2578":3043},{"_2580":3044},{"_452":2582},{"_2578":3046},{"_2580":3047},{"_452":2582},{"_2578":3049},{"_2580":3050},{"_7":244,"_245":246,"_247":3051,"_249":3052},[255],{"_255":3053},{"_7":268,"_271":3054},[2591],{"_2578":3056},{"_2580":3057},{"_452":2582},{"_2578":3059},{"_2580":3060},{"_452":2582},{"_2578":3062},{"_2580":3063},{"_452":2582},{"_2578":3065},{"_2580":3066},{"_452":2582},{"_2578":3068},{"_2580":3069},{"_452":2582},{"_2578":3071},{"_2580":3072},{"_452":2582},{"_2578":3074},{"_2580":3075},{"_452":2582},{"_2578":3077},{"_2580":3078},{"_452":2582},"Certificate enrolled as a DRAFT version; nothing signs with it yet",{"_2609":3085},{"_2578":3082},{"_2580":3083},{"_452":3084},"#/components/schemas/CertificateEnrolledResponse",{"_2580":3086},{"_7":268,"_269":270},"Idempotent replay: the version this key already produced",{"_2578":3089},{"_2580":3090},{"_452":3091},"#/components/schemas/CertificateEnrollmentReplayResponse",{"_2578":3093},{"_2580":3094,"_1663":3095},{"_452":3102},{"_1338":3096},{"_3007":3097},{"_471":520,"_721":3098,"_723":3099,"_725":3100,"_727":3101},"MIIKlgIBAzCCClwGCSqGSIb3DQEHAaCCCk0EggpJMIIKRTCCBgYGCSqGSIb3DQEHAaCCBfcEggXzMIIF7zCCBesGCyqGSIb3DQEMCgECoIIE","la-clave-del-pkcs12","MODDATOS","moddatos","#/components/schemas/EnrollCertificateRequest",{"_2240":468,"_2613":27,"_247":23,"_2580":3106},{"_2240":3014,"_2613":3015,"_247":23,"_2580":3105},{"_7":268,"_732":447,"_632":634,"_309":734},{"_7":268,"_269":270},{"_2464":3108},[],{"_29":3189,"_427":3190,"_1019":3191,"_11":3192,"_2556":3193,"_2558":2802,"_2559":3194,"_2561":3195},{"_29":3111,"_427":3112,"_1019":3113,"_11":3114,"_2556":3115,"_2558":2939,"_2559":3116,"_2941":3117,"_2561":3118},[2854],"createOrganizationCompany","Register a client company under the calling organization","Creates the fiscal entity a platform will issue for. Requires an ORGANIZATION credential (apf_org_v2_...) carrying companies:manage; a company credential is refused by the token prefix before any lookup happens. The company is created ACTIVE but can sign nothing: it has no certificate, and since migration 000052 the only route to an ACTIVE certificate is a comprobante SUNAT accepted. Every call writes an ops.audit_events row naming the organization, the credential and the RUC, in the same transaction as the company.",[3187],[3185],{"_247":23,"_2576":3176},{"_2944":3119,"_2806":3120,"_2565":3121,"_2567":3122,"_2569":3123,"_2868":3124,"_2870":3125,"_2872":3126,"_2629":3127,"_2571":3128,"_2573":3129,"_2635":3130},{"_11":3168,"_2603":3169,"_2576":3170},{"_11":2575,"_2576":3165},{"_11":2575,"_2576":3162},{"_11":2908,"_2576":3159},{"_11":2904,"_2576":3156},{"_11":2900,"_2576":3153},{"_11":2575,"_2576":3150},{"_11":2575,"_2576":3147},{"_11":2575,"_2576":3144},{"_11":2583,"_2576":3137},{"_11":2575,"_2576":3134},{"_11":2575,"_2576":3131},{"_2578":3132},{"_2580":3133},{"_452":2582},{"_2578":3135},{"_2580":3136},{"_452":2582},{"_2578":3138},{"_2580":3139},{"_7":244,"_245":246,"_247":3140,"_249":3141},[255],{"_255":3142},{"_7":268,"_271":3143},[2591],{"_2578":3145},{"_2580":3146},{"_452":2582},{"_2578":3148},{"_2580":3149},{"_452":2582},{"_2578":3151},{"_2580":3152},{"_452":2582},{"_2578":3154},{"_2580":3155},{"_452":2582},{"_2578":3157},{"_2580":3158},{"_452":2582},{"_2578":3160},{"_2580":3161},{"_452":2582},{"_2578":3163},{"_2580":3164},{"_452":2582},{"_2578":3166},{"_2580":3167},{"_452":2582},"Company registered under this organization",{"_2609":3174},{"_2578":3171},{"_2580":3172},{"_452":3173},"#/components/schemas/OrganizationCompanyResponse",{"_2580":3175},{"_7":268,"_269":270},{"_2578":3177},{"_2580":3178,"_1663":3179},{"_452":3184},{"_1338":3180},{"_3007":3181},{"_354":3182,"_367":3183,"_471":520},"20698765432","DISTRIBUIDORA SAN MARTIN S.A.C.","#/components/schemas/CreateOrganizationCompanyRequest",{"_2240":3014,"_2613":3015,"_247":23,"_2580":3186},{"_7":268,"_732":447,"_632":634,"_309":734},{"_2464":3188},[],[2854],"listOrganizationCompanies","List the client companies of the calling organization","The read that makes this surface usable: every company, with the nine capability flags that decide what it may do and the state of the certificate that decides whether it may sign at all. Keyset paginated on the RUC, which is unique platform-wide, so a page cannot skip or repeat a company because another was registered mid-scan. INACTIVE companies are not listed. Requires organizations:read.",[3240],[3233,3234],{"_2563":3196,"_2806":3197,"_2565":3198,"_2567":3199,"_2571":3200,"_2573":3201,"_2635":3202},{"_11":3225,"_2603":3226,"_2576":3227},{"_11":2838,"_2576":3222},{"_11":2575,"_2576":3219},{"_11":2831,"_2576":3216},{"_11":2583,"_2576":3209},{"_11":2575,"_2576":3206},{"_11":2575,"_2576":3203},{"_2578":3204},{"_2580":3205},{"_452":2582},{"_2578":3207},{"_2580":3208},{"_452":2582},{"_2578":3210},{"_2580":3211},{"_7":244,"_245":246,"_247":3212,"_249":3213},[255],{"_255":3214},{"_7":268,"_271":3215},[2591],{"_2578":3217},{"_2580":3218},{"_452":2582},{"_2578":3220},{"_2580":3221},{"_452":2582},{"_2578":3223},{"_2580":3224},{"_452":2582},"One page of client companies with their capability and certificate state",{"_2609":3231},{"_2578":3228},{"_2580":3229},{"_452":3230},"#/components/schemas/OrganizationCompanyListResponse",{"_2580":3232},{"_7":268,"_269":270},{"_2240":973,"_2613":2736,"_247":246,"_2580":3238},{"_2240":3235,"_2613":2736,"_247":246,"_11":3236,"_2580":3237},"cursor","The RUC the previous page ended on; this page starts strictly after it.",{"_7":268,"_309":394},{"_7":333,"_334":447,"_919":634,"_1338":3239},50,{"_2464":3241},[],{"_29":3317,"_427":3318,"_1019":3319,"_11":3320,"_2556":3321,"_2558":2426,"_2559":3322,"_2561":3323},{"_29":3244,"_427":3245,"_1019":3246,"_11":3247,"_2556":3248,"_2558":2426,"_2559":3249,"_2561":3250},[3316],"getCertificateActivation","Read the verdict of this version's activation probe","The poll target the 202 names. Reports the probe's own status, the certificate's status beside it — they are two different questions, and a probe that ended REJECTED leaves a version that is still DRAFT — and the SUNAT verdict verbatim, because a responseCode is what tells an operator which certificate to replace where 'activation failed' tells them nothing. Requires no Idempotency-Key: it is a read. A version that never requested activation answers 404 CERTIFICATE_ACTIVATION_NOT_FOUND, which is not the same as an unknown id: the version exists and simply has no attempt against it.",[3314],[3312],{"_2563":3251,"_2806":3252,"_2565":3253,"_2567":3254,"_2569":3255,"_2868":3256,"_2870":3257,"_2872":3258,"_2629":3259,"_2571":3260,"_2573":3261,"_2635":3262},{"_11":3304,"_2603":3305,"_2576":3306},{"_11":2575,"_2576":3301},{"_11":2575,"_2576":3298},{"_11":3294,"_2576":3295},{"_11":2575,"_2576":3291},{"_11":3287,"_2576":3288},{"_11":2575,"_2576":3284},{"_11":2575,"_2576":3281},{"_11":3277,"_2576":3278},{"_11":2583,"_2576":3270},{"_11":2575,"_2576":3267},{"_11":3263,"_2576":3264},"CERTIFICATE_ENROLLMENT_UNAVAILABLE: the private signing boundary is unreachable. CERTIFICATE_ACTIVATION_UNAVAILABLE: the durable probe could not be started, so nothing was sent to SUNAT and the version is untouched; retry with the same Idempotency-Key, which adopts the attempt already recorded instead of opening a second one.",{"_2578":3265},{"_2580":3266},{"_452":2582},{"_2578":3268},{"_2580":3269},{"_452":2582},{"_2578":3271},{"_2580":3272},{"_7":244,"_245":246,"_247":3273,"_249":3274},[255],{"_255":3275},{"_7":268,"_271":3276},[2591],"INVALID_CERTIFICATE_ENROLLMENT for a malformed body, or CERTIFICATE_REJECTED when a validation refused the upload. details[0].field is one of environment, pfx, pfxPassword, solUser or solPassword and details[0].reason names the rule. No value from the upload or from the certificate is ever echoed.",{"_2578":3279},{"_2580":3280},{"_452":2582},{"_2578":3282},{"_2580":3283},{"_452":2582},{"_2578":3285},{"_2580":3286},{"_452":2582},"COMPANY_NOT_ENROLLABLE when the company is not ACTIVE, CERTIFICATE_VERSION_CONFLICT when another enrolment took the version, CERTIFICATE_NOT_ACTIVATABLE when the version is revoked or expired. CERTIFICATE_ALREADY_PROBED when this version has already been probed, whatever the verdict was: a probe consumes F000- at SUNAT and that number is never reissued, so a version that has been probed once cannot be probed again — enrol a new one. CERTIFICATE_ACTIVATION_IN_FLIGHT when another attempt on this version has not settled yet; poll GET /api/v2/certificates/{id}/activation rather than starting a second probe. CERTIFICATE_FIRST_ISSUE_OCCUPIED when a PRODUCTION version is asked to arm for activation by first issue and the company already holds one that is ACTIVE or already armed: at most one version per company and environment can be either, and this mechanism exists for a company that has none.",{"_2578":3289},{"_2580":3290},{"_452":2582},{"_2578":3292},{"_2580":3293},{"_452":2582},"Authenticated credential lacks certificates:manage",{"_2578":3296},{"_2580":3297},{"_452":2582},{"_2578":3299},{"_2580":3300},{"_452":2582},{"_2578":3302},{"_2580":3303},{"_452":2582},"The latest activation attempt recorded for this version",{"_2609":3310},{"_2578":3307},{"_2580":3308},{"_452":3309},"#/components/schemas/CertificateActivationStatusResponse",{"_2580":3311},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":3313},{"_7":268,"_269":270},{"_2464":3315},[],"Certificates",[3316],"activateCertificate","Prove a DRAFT version against SUNAT and activate it only if SUNAT accepts","Requests activation of the named DRAFT. It does NOT promote it in the request, in either environment: a version becomes ACTIVE only when SUNAT has accepted a comprobante signed with it. What differs is WHICH comprobante, and the mechanism field in the 202 says which of the two you got.\n\nBETA — mechanism PROBE. This API signs a real factura with the DRAFT certificate and sends it to SUNAT beta; the version becomes ACTIVE only if SUNAT accepts it. A certificate that cannot issue is therefore never activated, which is the whole point — the behaviour before this promoted on request, and the first document the tenant tried to issue was the one that discovered the key was unusable. The probe issues documentType 01 on the reserved series F000 with number equal to the enrolment version, so it is unique per version and never reused. It writes no row in the document collections: it is not a comprobante of the tenant's, it is not listed, it has no artifacts and it consumes no quota. Because a SUNAT round trip can take up to the dispatch timeout, this answers 202 with an operationId and a statusPath rather than blocking; poll GET /api/v2/certificates/{id}/activation for the verdict.\n\nPRODUCTION — mechanism FIRST_ISSUE, and it is a different shape because the probe cannot exist here. A probe in production is a REAL comprobante: it enters the taxpayer's registro de ventas and is withdrawn only by an accepted comunicación de baja. Inventing a sale to prove a key is not this platform's decision to make, and refusing to activate at all — which is what this route did until now — left a taxpayer with a certificate that could never sign and a company that could never send. So nothing is sent. The version is ARMED: its status becomes PENDING_FIRST_ISSUE, it signs your documents from this response onwards, and the FIRST comprobante you issue that SUNAT accepts or observes promotes it to ACTIVE in the same transaction that records that CDR — along with the company capabilities that follow a first activation. Nothing is emitted that you were not going to emit anyway.\n\nIf SUNAT then refuses that first comprobante because of the CERTIFICATE OR THE SOL CREDENTIALS — a wrong password, an unknown or inactive SOL user, no CPE profile, a file whose RUC is not the user's — the version is RETIRED and you enrol another. If SUNAT refuses it for anything else, including every CDR rejection about the CONTENT of the document, the version STAYS ARMED and your next comprobante tries again with the same key. A rejection is a statement about the document, not about the certificate, and retiring a good key over one is worse than leaving it pending.\n\nArming is refused with 409 CERTIFICATE_FIRST_ISSUE_OCCUPIED when the company already has a PRODUCTION version that is ACTIVE or already armed; at most one version per company and environment can be either. That means this mechanism does not renew: it is for a company with no signing certificate at all.\n\nEverything decidable without SUNAT is still refused synchronously and by name in both environments: not a DRAFT, revoked, expired, already probed, another attempt in flight. Idempotency-Key is required: a retry after a lost response adopts what was already recorded with replay=true, and re-sending the same key also repairs an attempt whose row committed but whose probe never started.",[3409],[3405,3406],{"_3324":3325,"_2806":3326,"_2565":3327,"_2567":3328,"_2569":3329,"_2868":3330,"_2870":3331,"_2872":3332,"_2629":3333,"_2571":3334,"_2573":3335,"_2635":3336},"202",{"_11":3374,"_2603":3375,"_2576":3376},{"_11":2575,"_2576":3371},{"_11":2575,"_2576":3368},{"_11":3294,"_2576":3365},{"_11":2575,"_2576":3362},{"_11":3287,"_2576":3359},{"_11":2575,"_2576":3356},{"_11":2575,"_2576":3353},{"_11":3277,"_2576":3350},{"_11":2583,"_2576":3343},{"_11":2575,"_2576":3340},{"_11":3263,"_2576":3337},{"_2578":3338},{"_2580":3339},{"_452":2582},{"_2578":3341},{"_2580":3342},{"_452":2582},{"_2578":3344},{"_2580":3345},{"_7":244,"_245":246,"_247":3346,"_249":3347},[255],{"_255":3348},{"_7":268,"_271":3349},[2591],{"_2578":3351},{"_2580":3352},{"_452":2582},{"_2578":3354},{"_2580":3355},{"_452":2582},{"_2578":3357},{"_2580":3358},{"_452":2582},{"_2578":3360},{"_2580":3361},{"_452":2582},{"_2578":3363},{"_2580":3364},{"_452":2582},{"_2578":3366},{"_2580":3367},{"_452":2582},{"_2578":3369},{"_2580":3370},{"_452":2582},{"_2578":3372},{"_2580":3373},{"_452":2582},"Accepted and durably committed. Under mechanism PROBE the version is still DRAFT and whatever signs this tenant's documents keeps signing them until SUNAT answers. Under mechanism FIRST_ISSUE the version is PENDING_FIRST_ISSUE and is signing already — the tenant had nothing signing before, which is the only situation in which arming is allowed.",{"_2609":3399,"_3400":3401},{"_2578":3377},{"_2580":3378,"_1663":3379},{"_452":3398},{"_3380":3381,"_3382":3383},"betaProbe",{"_1019":3391,"_3007":3392},"productionFirstIssue",{"_1019":3384,"_11":3385,"_3007":3386},"PRODUCTION — armed, signing already, promoted by the next accepted comprobante","Nothing was sent to SUNAT and there is no verdict coming, which is why operationId, activationId and probe are all null. Do not poll statusPath waiting for it to move: the next thing that moves this version is a comprobante you issue. Note certificateStatus: the key IS in use from here, and it is not ACTIVE yet.",{"_251":273,"_253":3387,"_527":569,"_427":-5,"_466":-5,"_468":3388,"_532":3388,"_445":447,"_471":521,"_369":510,"_474":510,"_476":-5,"_539":3389,"_478":3390,"_542":246},"0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d","5f4e3d2c-1b0a-4998-8776-655443322110","/api/v2/certificates/5f4e3d2c-1b0a-4998-8776-655443322110/activation","2026-08-14T15:04:05.000Z","BETA — a factura on F000 is on its way to SUNAT",{"_251":273,"_253":3393,"_527":568,"_427":3394,"_466":3394,"_468":3395,"_532":3395,"_445":1908,"_471":520,"_369":383,"_474":509,"_476":3396,"_539":3397,"_478":3390,"_542":246},"6f0b1a3e-9c2d-4f51-8f0a-2b7c4d5e6f70","1c9a7f52-3d84-4b16-9d0e-8a4f2c6b1e30","b2d4f6a8-1c3e-4a5b-8d7f-9e0a1b2c3d4e",{"_429":455,"_431":505,"_433":1614},"/api/v2/certificates/b2d4f6a8-1c3e-4a5b-8d7f-9e0a1b2c3d4e/activation","#/components/schemas/CertificateActivationAcceptedResponse",{"_2580":3404},"Location",{"_2580":3402,"_11":3403},{"_7":268},"Same value as statusPath, for a client that follows headers.",{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":3408},{"_2240":3014,"_2613":3015,"_247":23,"_2580":3407},{"_7":268,"_732":447,"_632":634,"_309":734},{"_7":268,"_269":270},{"_2464":3410},[],{"_29":3478,"_427":3479,"_1019":3480,"_11":3481,"_2556":3482,"_2558":2426,"_2559":3483,"_2941":3484,"_2561":3485},{"_29":3413,"_427":3414,"_1019":3415,"_11":3416,"_2556":3417,"_2558":2426,"_2561":3418},[3316],"listCertificates","List this tenant's certificate versions with their state and validity","Returns every enrolled version of the authenticated tenant, newest first, with its status (DRAFT, ACTIVE or RETIRED), the certificate's identity and validity window, and currentlyValid, which answers whether the version could sign right now. Object keys and secret references are deliberately absent: they are the internal storage layout of the signing boundary and there is nothing a caller can do with them.",[3476],{"_2563":3419,"_2806":3420,"_2565":3421,"_2567":3422,"_2569":3423,"_2868":3424,"_2870":3425,"_2872":3426,"_2629":3427,"_2571":3428,"_2573":3429,"_2635":3430},{"_11":3468,"_2603":3469,"_2576":3470},{"_11":2575,"_2576":3465},{"_11":2575,"_2576":3462},{"_11":3294,"_2576":3459},{"_11":2575,"_2576":3456},{"_11":3287,"_2576":3453},{"_11":2575,"_2576":3450},{"_11":2575,"_2576":3447},{"_11":3277,"_2576":3444},{"_11":2583,"_2576":3437},{"_11":2575,"_2576":3434},{"_11":3263,"_2576":3431},{"_2578":3432},{"_2580":3433},{"_452":2582},{"_2578":3435},{"_2580":3436},{"_452":2582},{"_2578":3438},{"_2580":3439},{"_7":244,"_245":246,"_247":3440,"_249":3441},[255],{"_255":3442},{"_7":268,"_271":3443},[2591],{"_2578":3445},{"_2580":3446},{"_452":2582},{"_2578":3448},{"_2580":3449},{"_452":2582},{"_2578":3451},{"_2580":3452},{"_452":2582},{"_2578":3454},{"_2580":3455},{"_452":2582},{"_2578":3457},{"_2580":3458},{"_452":2582},{"_2578":3460},{"_2580":3461},{"_452":2582},{"_2578":3463},{"_2580":3464},{"_452":2582},{"_2578":3466},{"_2580":3467},{"_452":2582},"Certificate versions owned by the authenticated tenant",{"_2609":3474},{"_2578":3471},{"_2580":3472},{"_452":3473},"#/components/schemas/CertificateListResponse",{"_2580":3475},{"_7":268,"_269":270},{"_2464":3477},[],[3316],"enrollCertificate","Enrol a signing certificate and its SOL credentials as a DRAFT version","Uploads the four secrets a Peruvian issuer needs: the PKCS#12 certificate (base64), its password, and the SOL user and password of the SUNAT secondary user. All four together, because a certificate signs the XML and the SOL credentials authenticate sendBill: one without the other cannot submit anything. The upload is validated BEFORE it is stored — the PFX must open with the supplied password, the certificate subject RUC must be this company's RUC, the validity window must cover now, and the declared environment must be the one the company is enrolled for — and only then sealed. The new version is created in DRAFT and signs NOTHING until POST /api/v2/certificates/{id}/activation. The certificate and the passwords are never stored in plaintext, never logged and never returned; only the sealed envelopes reach storage, and only their digests reach the database. A repeated Idempotency-Key answers 200 with replay=true and the version the first call produced, without re-sealing anything; the same key with a different certificate is a 409.",[3554],[3552],{"_247":23,"_2576":3546},{"_2563":3486,"_2944":3487,"_2806":3488,"_2565":3489,"_2567":3490,"_2569":3491,"_2868":3492,"_2870":3493,"_2872":3494,"_2629":3495,"_2571":3496,"_2573":3497,"_2635":3498},{"_11":3542,"_2576":3543},{"_11":3079,"_2603":3536,"_2576":3537},{"_11":2575,"_2576":3533},{"_11":2575,"_2576":3530},{"_11":3294,"_2576":3527},{"_11":2575,"_2576":3524},{"_11":3287,"_2576":3521},{"_11":2575,"_2576":3518},{"_11":2575,"_2576":3515},{"_11":3277,"_2576":3512},{"_11":2583,"_2576":3505},{"_11":2575,"_2576":3502},{"_11":3263,"_2576":3499},{"_2578":3500},{"_2580":3501},{"_452":2582},{"_2578":3503},{"_2580":3504},{"_452":2582},{"_2578":3506},{"_2580":3507},{"_7":244,"_245":246,"_247":3508,"_249":3509},[255],{"_255":3510},{"_7":268,"_271":3511},[2591],{"_2578":3513},{"_2580":3514},{"_452":2582},{"_2578":3516},{"_2580":3517},{"_452":2582},{"_2578":3519},{"_2580":3520},{"_452":2582},{"_2578":3522},{"_2580":3523},{"_452":2582},{"_2578":3525},{"_2580":3526},{"_452":2582},{"_2578":3528},{"_2580":3529},{"_452":2582},{"_2578":3531},{"_2580":3532},{"_452":2582},{"_2578":3534},{"_2580":3535},{"_452":2582},{"_2609":3540},{"_2578":3538},{"_2580":3539},{"_452":3084},{"_2580":3541},{"_7":268,"_269":270},"Idempotent replay: the version this key already produced, in the listing shape",{"_2578":3544},{"_2580":3545},{"_452":3091},{"_2578":3547},{"_2580":3548,"_1663":3549},{"_452":3102},{"_1338":3550},{"_3007":3551},{"_471":520,"_721":3098,"_723":3099,"_725":3100,"_727":3101},{"_2240":3014,"_2613":3015,"_247":23,"_2580":3553},{"_7":268,"_732":447,"_632":634,"_309":734},{"_2464":3555},[],{"_29":3557,"_427":3558,"_1019":3559,"_11":3560,"_2556":3561,"_2558":2436,"_2559":3562,"_2561":3563},[3630],"rotateWebhookSecret","Mint the next signing secret version","Creates the next secret version and switches signing to it immediately; there is no overlap window, so install the new secret before rotating. The new secret is returned exactly once. A replay of the same Idempotency-Key answers 200 with replay=true and no secret; if the value was lost, rotate again with a new key.",[3628],[3624,3625],{"_2563":3564,"_2944":3565,"_2806":3566,"_2565":3567,"_2567":3568,"_2569":3569,"_2868":3570,"_2870":3571,"_2872":3572,"_2629":3573,"_2571":3574,"_2573":3575},{"_11":3620,"_2576":3621},{"_11":3612,"_2603":3613,"_2576":3614},{"_11":2575,"_2576":3609},{"_11":2575,"_2576":3606},{"_11":3602,"_2576":3603},{"_11":2575,"_2576":3599},{"_11":2575,"_2576":3596},{"_11":2575,"_2576":3593},{"_11":2575,"_2576":3590},{"_11":3586,"_2576":3587},{"_11":2583,"_2576":3579},{"_11":2575,"_2576":3576},{"_2578":3577},{"_2580":3578},{"_452":2582},{"_2578":3580},{"_2580":3581},{"_7":244,"_245":246,"_247":3582,"_249":3583},[255],{"_255":3584},{"_7":268,"_271":3585},[2591],"Payload invalid, or the destination was refused by the anti-SSRF gate. The error code is INVALID_WEBHOOK_DESTINATION and details[0].reason names the rule that refused it.",{"_2578":3588},{"_2580":3589},{"_452":2582},{"_2578":3591},{"_2580":3592},{"_452":2582},{"_2578":3594},{"_2580":3595},{"_452":2582},{"_2578":3597},{"_2580":3598},{"_452":2582},{"_2578":3600},{"_2580":3601},{"_452":2582},"Authenticated credential lacks webhooks:manage",{"_2578":3604},{"_2580":3605},{"_452":2582},{"_2578":3607},{"_2580":3608},{"_452":2582},{"_2578":3610},{"_2580":3611},{"_452":2582},"New secret version; the secret is present exactly here",{"_2609":3618},{"_2578":3615},{"_2580":3616},{"_452":3617},"#/components/schemas/WebhookSecretRotationResponse",{"_2580":3619},{"_7":268,"_269":270},"Idempotent replay; the secret is NOT repeated",{"_2578":3622},{"_2580":3623},{"_452":3617},{"_2240":468,"_2613":27,"_247":23,"_2580":3627},{"_2240":3014,"_2613":3015,"_247":23,"_2580":3626},{"_7":268,"_732":447,"_632":634,"_309":734},{"_7":268,"_269":270},{"_2464":3629},[],"Webhooks","patch",{"_29":3701,"_427":3702,"_1019":3703,"_11":3704,"_2556":3705,"_2558":2436,"_2559":3706,"_2941":3707,"_2561":3708},"delete",{"_29":3635,"_427":3636,"_1019":3637,"_11":3638,"_2556":3639,"_2558":2436,"_2559":3640,"_2561":3641},[3630],"deleteWebhookSubscription","Delete a subscription and everything still aimed at it","Deletes the subscription, its secret versions and its pending and dead-lettered deliveries. Stored events survive, because an event may still be owed to another subscription.",[3699],[3695,3696],{"_2563":3642,"_2806":3643,"_2565":3644,"_2567":3645,"_2569":3646,"_2868":3647,"_2870":3648,"_2872":3649,"_2629":3650,"_2571":3651,"_2573":3652},{"_11":3687,"_2603":3688,"_2576":3689},{"_11":2575,"_2576":3684},{"_11":2575,"_2576":3681},{"_11":3602,"_2576":3678},{"_11":2575,"_2576":3675},{"_11":2575,"_2576":3672},{"_11":2575,"_2576":3669},{"_11":2575,"_2576":3666},{"_11":3586,"_2576":3663},{"_11":2583,"_2576":3656},{"_11":2575,"_2576":3653},{"_2578":3654},{"_2580":3655},{"_452":2582},{"_2578":3657},{"_2580":3658},{"_7":244,"_245":246,"_247":3659,"_249":3660},[255],{"_255":3661},{"_7":268,"_271":3662},[2591],{"_2578":3664},{"_2580":3665},{"_452":2582},{"_2578":3667},{"_2580":3668},{"_452":2582},{"_2578":3670},{"_2580":3671},{"_452":2582},{"_2578":3673},{"_2580":3674},{"_452":2582},{"_2578":3676},{"_2580":3677},{"_452":2582},{"_2578":3679},{"_2580":3680},{"_452":2582},{"_2578":3682},{"_2580":3683},{"_452":2582},{"_2578":3685},{"_2580":3686},{"_452":2582},"Subscription deleted",{"_2609":3693},{"_2578":3690},{"_2580":3691},{"_452":3692},"#/components/schemas/WebhookSubscriptionDeletedResponse",{"_2580":3694},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":3698},{"_2240":3014,"_2613":3015,"_247":23,"_2580":3697},{"_7":268,"_732":447,"_632":634,"_309":734},{"_7":268,"_269":270},{"_2464":3700},[],[3630],"updateWebhookSubscription","Change a subscription's destination, events or status","Partial update. status=PAUSED stops the fan-out without deleting the subscription or its secret; paused subscriptions receive no new deliveries and are not selected when an event is published. A new url is revalidated by the same anti-SSRF gate as creation.",[3772],[3768,3769],{"_247":23,"_2576":3761},{"_2563":3709,"_2806":3710,"_2565":3711,"_2567":3712,"_2569":3713,"_2868":3714,"_2870":3715,"_2872":3716,"_2629":3717,"_2571":3718,"_2573":3719},{"_11":3754,"_2603":3755,"_2576":3756},{"_11":2575,"_2576":3751},{"_11":2575,"_2576":3748},{"_11":3602,"_2576":3745},{"_11":2575,"_2576":3742},{"_11":2575,"_2576":3739},{"_11":2575,"_2576":3736},{"_11":2575,"_2576":3733},{"_11":3586,"_2576":3730},{"_11":2583,"_2576":3723},{"_11":2575,"_2576":3720},{"_2578":3721},{"_2580":3722},{"_452":2582},{"_2578":3724},{"_2580":3725},{"_7":244,"_245":246,"_247":3726,"_249":3727},[255],{"_255":3728},{"_7":268,"_271":3729},[2591],{"_2578":3731},{"_2580":3732},{"_452":2582},{"_2578":3734},{"_2580":3735},{"_452":2582},{"_2578":3737},{"_2580":3738},{"_452":2582},{"_2578":3740},{"_2580":3741},{"_452":2582},{"_2578":3743},{"_2580":3744},{"_452":2582},{"_2578":3746},{"_2580":3747},{"_452":2582},{"_2578":3749},{"_2580":3750},{"_452":2582},{"_2578":3752},{"_2580":3753},{"_452":2582},"Updated subscription",{"_2609":3759},{"_2578":3757},{"_2580":3758},{"_452":785},{"_2580":3760},{"_7":268,"_269":270},{"_2578":3762},{"_2580":3763,"_1663":3764},{"_452":3767},{"_1338":3765},{"_3007":3766},{"_369":811},"#/components/schemas/UpdateWebhookSubscriptionRequest",{"_2240":468,"_2613":27,"_247":23,"_2580":3771},{"_2240":3014,"_2613":3015,"_247":23,"_2580":3770},{"_7":268,"_732":447,"_632":634,"_309":734},{"_7":268,"_269":270},{"_2464":3773},[],{"_29":3837,"_427":3838,"_1019":3839,"_11":3840,"_2556":3841,"_2558":2436,"_2559":3842,"_2941":3843,"_2561":3844},{"_29":3776,"_427":3777,"_1019":3778,"_11":3779,"_2556":3780,"_2558":2436,"_2561":3781},[3630],"listWebhookSubscriptions","List this tenant's webhook subscriptions","Returns every subscription of the authenticated tenant with its destination, subscribed events, status and current secret version. No signing secret is ever included.",[3835],{"_2563":3782,"_2806":3783,"_2565":3784,"_2567":3785,"_2569":3786,"_2868":3787,"_2870":3788,"_2872":3789,"_2629":3790,"_2571":3791,"_2573":3792},{"_11":3827,"_2603":3828,"_2576":3829},{"_11":2575,"_2576":3824},{"_11":2575,"_2576":3821},{"_11":3602,"_2576":3818},{"_11":2575,"_2576":3815},{"_11":2575,"_2576":3812},{"_11":2575,"_2576":3809},{"_11":2575,"_2576":3806},{"_11":3586,"_2576":3803},{"_11":2583,"_2576":3796},{"_11":2575,"_2576":3793},{"_2578":3794},{"_2580":3795},{"_452":2582},{"_2578":3797},{"_2580":3798},{"_7":244,"_245":246,"_247":3799,"_249":3800},[255],{"_255":3801},{"_7":268,"_271":3802},[2591],{"_2578":3804},{"_2580":3805},{"_452":2582},{"_2578":3807},{"_2580":3808},{"_452":2582},{"_2578":3810},{"_2580":3811},{"_452":2582},{"_2578":3813},{"_2580":3814},{"_452":2582},{"_2578":3816},{"_2580":3817},{"_452":2582},{"_2578":3819},{"_2580":3820},{"_452":2582},{"_2578":3822},{"_2580":3823},{"_452":2582},{"_2578":3825},{"_2580":3826},{"_452":2582},"Subscriptions owned by the authenticated tenant",{"_2609":3833},{"_2578":3830},{"_2580":3831},{"_452":3832},"#/components/schemas/WebhookSubscriptionListResponse",{"_2580":3834},{"_7":268,"_269":270},{"_2464":3836},[],[3630],"createWebhookSubscription","Register a signed webhook destination for this tenant","Registers an HTTPS destination and the versioned events it should receive, and mints the HMAC signing secret. The secret is returned EXACTLY ONCE, in this response: the API's database role holds no read privilege on the column that stores it, so it cannot be retrieved later by any route. A replay of the same Idempotency-Key answers 200 with replay=true and no secret. Destinations are admitted by an anti-SSRF gate: https only, default port only, no credentials in the URL, no fragment, and the host must be a public DNS name whose last label is alphabetic, which refuses every IP literal in every base as well as localhost, .internal, .local and cloud metadata names.",[3913],[3911],{"_247":23,"_2576":3902},{"_2563":3845,"_2944":3846,"_2806":3847,"_2565":3848,"_2567":3849,"_2569":3850,"_2868":3851,"_2870":3852,"_2872":3853,"_2629":3854,"_2571":3855,"_2573":3856},{"_11":3620,"_2576":3899},{"_11":3891,"_2603":3892,"_2576":3893},{"_11":2575,"_2576":3888},{"_11":2575,"_2576":3885},{"_11":3602,"_2576":3882},{"_11":2575,"_2576":3879},{"_11":2575,"_2576":3876},{"_11":2575,"_2576":3873},{"_11":2575,"_2576":3870},{"_11":3586,"_2576":3867},{"_11":2583,"_2576":3860},{"_11":2575,"_2576":3857},{"_2578":3858},{"_2580":3859},{"_452":2582},{"_2578":3861},{"_2580":3862},{"_7":244,"_245":246,"_247":3863,"_249":3864},[255],{"_255":3865},{"_7":268,"_271":3866},[2591],{"_2578":3868},{"_2580":3869},{"_452":2582},{"_2578":3871},{"_2580":3872},{"_452":2582},{"_2578":3874},{"_2580":3875},{"_452":2582},{"_2578":3877},{"_2580":3878},{"_452":2582},{"_2578":3880},{"_2580":3881},{"_452":2582},{"_2578":3883},{"_2580":3884},{"_452":2582},{"_2578":3886},{"_2580":3887},{"_452":2582},{"_2578":3889},{"_2580":3890},{"_452":2582},"Subscription created; the signing secret is present exactly here",{"_2609":3897},{"_2578":3894},{"_2580":3895},{"_452":3896},"#/components/schemas/WebhookSubscriptionCreatedResponse",{"_2580":3898},{"_7":268,"_269":270},{"_2578":3900},{"_2580":3901},{"_452":785},{"_2578":3903},{"_2580":3904,"_1663":3905},{"_452":3910},{"_1338":3906},{"_3007":3907},{"_799":3908,"_801":3909},"https://webhooks.example.com/apifact",[845,844,838,841,843,839,840,842],"#/components/schemas/CreateWebhookSubscriptionRequest",{"_2240":3014,"_2613":3015,"_247":23,"_2580":3912},{"_7":268,"_732":447,"_632":634,"_309":734},{"_2464":3914},[],{"_29":3916,"_427":3917,"_1019":3918,"_11":3919,"_2556":3920,"_2558":2433,"_2559":3921,"_2561":3922},[3979],"submitPerception","Durably request comprobante de percepción (CPE, 40) dispatch","The perception mirror of submitRetention: same 'otros CPE' service, same single-envelope fence, same AMBIGUOUS outcome for a dispatch whose CDR never arrived. Gated by submission_publication_enabled AND perception_issuance_enabled.",[3977],[3973,3974],{"_2563":3923,"_3324":3924,"_2806":3925,"_2565":3926,"_2567":3927,"_2569":3928,"_2868":3929,"_2571":3930,"_2573":3931,"_2635":3932},{"_11":3969,"_2576":3970},{"_11":3964,"_2576":3965},{"_11":2575,"_2576":3961},{"_11":2575,"_2576":3958},{"_11":3954,"_2576":3955},{"_11":2575,"_2576":3951},{"_11":3947,"_2576":3948},{"_11":2583,"_2576":3940},{"_11":2575,"_2576":3937},{"_11":3933,"_2576":3934},"The durable dispatch handle could not be started. Nothing reached SUNAT; retry with the same Idempotency-Key.",{"_2578":3935},{"_2580":3936},{"_452":2582},{"_2578":3938},{"_2580":3939},{"_452":2582},{"_2578":3941},{"_2580":3942},{"_7":244,"_245":246,"_247":3943,"_249":3944},[255],{"_255":3945},{"_7":268,"_271":3946},[2591],"The tenant capability is off, a dispatch is already in flight, or the document has already settled. A settled document is never redispatched: an ambiguous submission is fenced for reconciliation, never resent.",{"_2578":3949},{"_2580":3950},{"_452":2582},{"_2578":3952},{"_2580":3953},{"_452":2582},"Authenticated credential lacks documents:submit",{"_2578":3956},{"_2580":3957},{"_452":2582},{"_2578":3959},{"_2580":3960},{"_452":2582},{"_2578":3962},{"_2580":3963},{"_452":2582},"Dispatch request durably accepted",{"_2578":3966},{"_2580":3967},{"_452":3968},"#/components/schemas/PaymentRegimeOperationResponse","Idempotent replay",{"_2578":3971},{"_2580":3972},{"_452":3968},{"_2240":468,"_2613":27,"_247":23,"_2580":3976},{"_2240":3014,"_2613":3015,"_247":23,"_2580":3975},{"_7":268,"_732":447,"_632":634},{"_7":268,"_269":270},{"_2464":3978},[],"Payment regimes",{"_29":3981,"_427":3982,"_1019":3983,"_11":3984,"_2556":3985,"_2558":2432,"_2559":3986,"_2561":3987},[3979],"getPerception","Get a tenant-owned comprobante de percepción (CPE, 40) and its references","Returns the stored header and every reference in the order the signed XML declares them, with the PEN base, the amount perceived and the total for each. netAmount = baseAmount + regimeAmount.",[4024],[4022],{"_2563":3988,"_2565":3989,"_2567":3990,"_2569":3991,"_2571":3992,"_2573":3993},{"_11":4014,"_2603":4015,"_2576":4016},{"_11":2575,"_2576":4011},{"_11":4007,"_2576":4008},{"_11":2575,"_2576":4004},{"_11":2583,"_2576":3997},{"_11":2575,"_2576":3994},{"_2578":3995},{"_2580":3996},{"_452":2582},{"_2578":3998},{"_2580":3999},{"_7":244,"_245":246,"_247":4000,"_249":4001},[255],{"_255":4002},{"_7":268,"_271":4003},[2591],{"_2578":4005},{"_2580":4006},{"_452":2582},"Authenticated credential lacks documents:read",{"_2578":4009},{"_2580":4010},{"_452":2582},{"_2578":4012},{"_2580":4013},{"_452":2582},"Header and references, in declaration order",{"_2609":4020},{"_2578":4017},{"_2580":4018},{"_452":4019},"#/components/schemas/PaymentRegimeResponse",{"_2580":4021},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":4023},{"_7":268,"_269":270},{"_2464":4025},[],{"_29":4027,"_427":4028,"_1019":4029,"_11":4030,"_2556":4031,"_2558":2430,"_2559":4032,"_2941":4033,"_2561":4034},[3979],"createPerception","Validate and durably create a comprobante de percepción (CPE, 40)","A comprobante de percepción declares the documents an agente de percepción is collecting, the collection made against each one, the amount charged on top and the total collected. It is the mirror of the retention and the only arithmetic difference is the sign. Creation is capability-gated per tenant (perception_issuance_enabled, off by default) and does not contact SUNAT.",[4127],[4125],{"_247":23,"_2576":4096},{"_2563":4035,"_2944":4036,"_2806":4037,"_2565":4038,"_2567":4039,"_2868":4040,"_2870":4041,"_2872":4042,"_2629":4043,"_2571":4044,"_2573":4045},{"_11":3969,"_2603":4090,"_2576":4091},{"_11":4083,"_2603":4084,"_2576":4085},{"_11":2575,"_2576":4080},{"_11":4072,"_2576":4073,"_2603":4074},{"_11":4068,"_2576":4069},{"_11":2575,"_2576":4065},{"_11":2575,"_2576":4062},{"_11":2575,"_2576":4059},{"_11":2575,"_2576":4056},{"_11":2583,"_2576":4049},{"_11":2575,"_2576":4046},{"_2578":4047},{"_2580":4048},{"_452":2582},{"_2578":4050},{"_2580":4051},{"_7":244,"_245":246,"_247":4052,"_249":4053},[255],{"_255":4054},{"_7":268,"_271":4055},[2591],{"_2578":4057},{"_2580":4058},{"_452":2582},{"_2578":4060},{"_2580":4061},{"_452":2582},{"_2578":4063},{"_2580":4064},{"_452":2582},{"_2578":4066},{"_2580":4067},{"_452":2582},"The credential lacks documents:create, or the declared agent is not the authenticated issuer. The agent of a CRE/CPE is its issuer, so declaring another RUC is an authorization failure rather than a payload error.",{"_2578":4070},{"_2580":4071},{"_452":2582},"Missing, malformed, expired, revoked or invalid credential",{"_2578":4078},{"_4075":4076},"WWW-Authenticate",{"_2580":4077},{"_7":268},{"_2580":4079},{"_452":2582},{"_2578":4081},{"_2580":4082},{"_452":2582},"comprobante de percepción (CPE, 40) created in VALIDATED state",{"_2609":4088},{"_2578":4086},{"_2580":4087},{"_452":3968},{"_2580":4089},{"_7":268,"_269":270},{"_2609":4094},{"_2578":4092},{"_2580":4093},{"_452":3968},{"_2580":4095},{"_7":268,"_269":270},{"_2578":4097},{"_2580":4098,"_1663":4099},{"_452":4124},{"_1338":4100},{"_3007":4101},{"_251":1343,"_429":1254,"_431":4102,"_433":1955,"_1205":4103,"_317":1337,"_1209":455,"_1211":1613,"_1322":4104,"_1324":4105,"_1326":4106,"_1328":4107},"P001","2026-08-12","Percepcion por venta interna aplicada al cobro de la factura",{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[4108],{"_429":455,"_431":4109,"_433":4110,"_1205":4103,"_1373":4111,"_317":1337,"_1376":4112,"_1279":4103},"F001","1024","1180.00",{"_468":1612,"_1153":4111,"_343":4103},"20512345678","COMERCIAL LOS ANDES S.A.C.","AV. AREQUIPA 4321","150122","MIRAFLORES","LIMA","20601030405","MI EMPRESA EMISORA S.A.C.","AV. JAVIER PRADO ESTE 1234","150131","SAN ISIDRO","#/components/schemas/CreatePerceptionRequest",{"_2240":3014,"_2613":3015,"_247":23,"_2580":4126},{"_7":268,"_732":447,"_632":634},{"_2464":4128},[],{"_29":4130,"_427":4131,"_1019":4132,"_11":4133,"_2556":4134,"_2558":2433,"_2559":4135,"_2561":4136},[3979],"submitRetention","Durably request comprobante de retención (CRE, 20) dispatch","Durably requests dispatch through SUNAT's 'otros CPE' service, which is a different deployment from the one that carries facturas and boletas. Answers 202 with the operation id allocated at creation. Dispatch is gated by submission_publication_enabled AND retention_issuance_enabled, both re-read under a row lock immediately before the outbound call. Exactly one envelope can ever leave for a given document: the attempt is fenced in the database before the call, and a run that finds a fenced attempt with no CDR settles AMBIGUOUS for reconciliation rather than resending.",[4185],[4181,4182],{"_2563":4137,"_3324":4138,"_2806":4139,"_2565":4140,"_2567":4141,"_2569":4142,"_2868":4143,"_2571":4144,"_2573":4145,"_2635":4146},{"_11":3969,"_2576":4178},{"_11":3964,"_2576":4175},{"_11":2575,"_2576":4172},{"_11":2575,"_2576":4169},{"_11":3954,"_2576":4166},{"_11":2575,"_2576":4163},{"_11":3947,"_2576":4160},{"_11":2583,"_2576":4153},{"_11":2575,"_2576":4150},{"_11":3933,"_2576":4147},{"_2578":4148},{"_2580":4149},{"_452":2582},{"_2578":4151},{"_2580":4152},{"_452":2582},{"_2578":4154},{"_2580":4155},{"_7":244,"_245":246,"_247":4156,"_249":4157},[255],{"_255":4158},{"_7":268,"_271":4159},[2591],{"_2578":4161},{"_2580":4162},{"_452":2582},{"_2578":4164},{"_2580":4165},{"_452":2582},{"_2578":4167},{"_2580":4168},{"_452":2582},{"_2578":4170},{"_2580":4171},{"_452":2582},{"_2578":4173},{"_2580":4174},{"_452":2582},{"_2578":4176},{"_2580":4177},{"_452":3968},{"_2578":4179},{"_2580":4180},{"_452":3968},{"_2240":468,"_2613":27,"_247":23,"_2580":4184},{"_2240":3014,"_2613":3015,"_247":23,"_2580":4183},{"_7":268,"_732":447,"_632":634},{"_7":268,"_269":270},{"_2464":4186},[],{"_29":4188,"_427":4189,"_1019":4190,"_11":4191,"_2556":4192,"_2558":2432,"_2559":4193,"_2561":4194},[3979],"getRetention","Get a tenant-owned comprobante de retención (CRE, 20) and its references","Returns the stored header and every reference in the order the signed XML declares them, with the PEN base, the amount withheld and the net for each. netAmount = baseAmount - regimeAmount.",[4228],[4226],{"_2563":4195,"_2565":4196,"_2567":4197,"_2569":4198,"_2571":4199,"_2573":4200},{"_11":4014,"_2603":4220,"_2576":4221},{"_11":2575,"_2576":4217},{"_11":4007,"_2576":4214},{"_11":2575,"_2576":4211},{"_11":2583,"_2576":4204},{"_11":2575,"_2576":4201},{"_2578":4202},{"_2580":4203},{"_452":2582},{"_2578":4205},{"_2580":4206},{"_7":244,"_245":246,"_247":4207,"_249":4208},[255],{"_255":4209},{"_7":268,"_271":4210},[2591],{"_2578":4212},{"_2580":4213},{"_452":2582},{"_2578":4215},{"_2580":4216},{"_452":2582},{"_2578":4218},{"_2580":4219},{"_452":2582},{"_2609":4224},{"_2578":4222},{"_2580":4223},{"_452":4019},{"_2580":4225},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":4227},{"_7":268,"_269":270},{"_2464":4229},[],{"_29":4231,"_427":4232,"_1019":4233,"_11":4234,"_2556":4235,"_2558":2430,"_2559":4236,"_2941":4237,"_2561":4238},[3979],"createRetention","Validate and durably create a comprobante de retención (CRE, 20)","A comprobante de retención declares the documents an agente de retención is settling, the payment made against each one, the amount withheld and the net handed over. Every monetary figure in the response is DERIVED from the payments and the declared rate; none may be supplied. Creation is capability-gated per tenant (retention_issuance_enabled, off by default) and does not contact SUNAT.",[4316],[4314],{"_247":23,"_2576":4297},{"_2563":4239,"_2944":4240,"_2806":4241,"_2565":4242,"_2567":4243,"_2868":4244,"_2870":4245,"_2872":4246,"_2629":4247,"_2571":4248,"_2573":4249},{"_11":3969,"_2603":4291,"_2576":4292},{"_11":4284,"_2603":4285,"_2576":4286},{"_11":2575,"_2576":4281},{"_11":4072,"_2576":4275,"_2603":4276},{"_11":4068,"_2576":4272},{"_11":2575,"_2576":4269},{"_11":2575,"_2576":4266},{"_11":2575,"_2576":4263},{"_11":2575,"_2576":4260},{"_11":2583,"_2576":4253},{"_11":2575,"_2576":4250},{"_2578":4251},{"_2580":4252},{"_452":2582},{"_2578":4254},{"_2580":4255},{"_7":244,"_245":246,"_247":4256,"_249":4257},[255],{"_255":4258},{"_7":268,"_271":4259},[2591],{"_2578":4261},{"_2580":4262},{"_452":2582},{"_2578":4264},{"_2580":4265},{"_452":2582},{"_2578":4267},{"_2580":4268},{"_452":2582},{"_2578":4270},{"_2580":4271},{"_452":2582},{"_2578":4273},{"_2580":4274},{"_452":2582},{"_2578":4279},{"_4075":4277},{"_2580":4278},{"_7":268},{"_2580":4280},{"_452":2582},{"_2578":4282},{"_2580":4283},{"_452":2582},"comprobante de retención (CRE, 20) created in VALIDATED state",{"_2609":4289},{"_2578":4287},{"_2580":4288},{"_452":3968},{"_2580":4290},{"_7":268,"_269":270},{"_2609":4295},{"_2578":4293},{"_2580":4294},{"_452":3968},{"_2580":4296},{"_7":268,"_269":270},{"_2578":4298},{"_2580":4299,"_1663":4300},{"_452":4313},{"_1338":4301},{"_3007":4302},{"_251":1343,"_429":1253,"_431":4303,"_433":4304,"_1205":4103,"_317":1337,"_1209":455,"_1211":1614,"_1322":4305,"_1324":4306,"_1326":4307,"_1328":4308},"R001","56","Retencion del regimen general aplicada al pago de la factura del proveedor",{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[4309],{"_429":455,"_431":4310,"_433":4311,"_1205":4103,"_1373":4111,"_317":1337,"_1376":4312,"_1279":4103},"F500","128",{"_468":1612,"_1153":4111,"_343":4103},"#/components/schemas/CreateRetentionRequest",{"_2240":3014,"_2613":3015,"_247":23,"_2580":4315},{"_7":268,"_732":447,"_632":634},{"_2464":4317},[],{"_29":4319,"_427":4320,"_1019":4321,"_11":4322,"_2556":4323,"_2558":2433,"_2559":4324,"_2561":4325},[4377],"requestVoidedCommunicationSubmission","Durably request void communication (RA) dispatch","Builds the VoidedDocuments UBL from the stored canonical payload, signs it, packages it and dispatches it with sendSummary inside the same private durable Workflow as the daily summary, with the same ticket cycle and the same non-resendable ambiguity fence.",[4375],[4371,4372],{"_2563":4326,"_3324":4327,"_2806":4328,"_2565":4329,"_2567":4330,"_2569":4331,"_2868":4332,"_2571":4333,"_2573":4334,"_2635":4335},{"_11":3969,"_2576":4368},{"_11":3964,"_2576":4364},{"_11":2575,"_2576":4361},{"_11":2575,"_2576":4358},{"_11":3954,"_2576":4355},{"_11":2575,"_2576":4352},{"_11":2575,"_2576":4349},{"_11":2583,"_2576":4342},{"_11":2575,"_2576":4339},{"_11":3933,"_2576":4336},{"_2578":4337},{"_2580":4338},{"_452":2582},{"_2578":4340},{"_2580":4341},{"_452":2582},{"_2578":4343},{"_2580":4344},{"_7":244,"_245":246,"_247":4345,"_249":4346},[255],{"_255":4347},{"_7":268,"_271":4348},[2591],{"_2578":4350},{"_2580":4351},{"_452":2582},{"_2578":4353},{"_2580":4354},{"_452":2582},{"_2578":4356},{"_2580":4357},{"_452":2582},{"_2578":4359},{"_2580":4360},{"_452":2582},{"_2578":4362},{"_2580":4363},{"_452":2582},{"_2578":4365},{"_2580":4366},{"_452":4367},"#/components/schemas/SummaryOperationResponse",{"_2578":4369},{"_2580":4370},{"_452":4367},{"_2240":468,"_2613":27,"_247":23,"_2580":4374},{"_2240":3014,"_2613":3015,"_247":23,"_2580":4373},{"_7":268,"_732":447,"_632":634},{"_7":268,"_269":270},{"_2464":4376},[],"Summaries",{"_29":4379,"_427":4380,"_1019":4381,"_11":4382,"_2556":4383,"_2558":2432,"_2559":4384,"_2561":4385},[4377],"getVoidedCommunication","Get a tenant-owned void communication (RA) and its ticket operation","Reports the durable operation behind the summary, including the SUNAT ticket once it exists. The ticket is the only handle that can resolve a dispatch out of band, so it is published rather than hidden.",[4421],[4419],{"_2563":4386,"_2565":4387,"_2567":4388,"_2569":4389,"_2571":4390,"_2573":4391},{"_11":4411,"_2603":4412,"_2576":4413},{"_11":2575,"_2576":4408},{"_11":4007,"_2576":4405},{"_11":2575,"_2576":4402},{"_11":2583,"_2576":4395},{"_11":2575,"_2576":4392},{"_2578":4393},{"_2580":4394},{"_452":2582},{"_2578":4396},{"_2580":4397},{"_7":244,"_245":246,"_247":4398,"_249":4399},[255],{"_255":4400},{"_7":268,"_271":4401},[2591],{"_2578":4403},{"_2580":4404},{"_452":2582},{"_2578":4406},{"_2580":4407},{"_452":2582},{"_2578":4409},{"_2580":4410},{"_452":2582},"Summary state and ticket operation",{"_2609":4417},{"_2578":4414},{"_2580":4415},{"_452":4416},"#/components/schemas/SummaryResponse",{"_2580":4418},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":4420},{"_7":268,"_269":270},{"_2464":4422},[],{"_29":4424,"_427":4425,"_1019":4426,"_11":4427,"_2556":4428,"_2558":2430,"_2559":4429,"_2941":4430,"_2561":4431},[4377],"createVoidedCommunication","Validate and durably create a void communication (RA)","A void communication (RA) withdraws already-issued facturas and the notes over them. Boleta 03 is deliberately not accepted: a boleta is annulled through a daily summary line with statusCode 3. Creation is capability-gated per tenant and does not contact SUNAT. The response reports the communication deadline; it never enforces it. A line naming a comprobante this API holds is checked against it: the comprobante must have been accepted or observed by SUNAT, and must not already be withdrawn or carried by another live communication. A line naming a comprobante this API does not hold is accepted and recorded as unlinked — see `references` — because an emitter may have issued it through another provider, on paper, or before integrating; SUNAT's own ERROR 2105 and 2323 police that case.",[4505],[4503],{"_247":23,"_2576":4492},{"_2563":4432,"_2944":4433,"_2806":4434,"_2565":4435,"_2567":4436,"_2868":4437,"_2870":4438,"_2872":4439,"_2629":4440,"_2571":4441,"_2573":4442},{"_11":3969,"_2603":4486,"_2576":4487},{"_11":4479,"_2603":4480,"_2576":4481},{"_11":2575,"_2576":4476},{"_11":4072,"_2576":4470,"_2603":4471},{"_11":4466,"_2576":4467},{"_11":4462,"_2576":4463},{"_11":2575,"_2576":4459},{"_11":2575,"_2576":4456},{"_11":2575,"_2576":4453},{"_11":2583,"_2576":4446},{"_11":2575,"_2576":4443},{"_2578":4444},{"_2580":4445},{"_452":2582},{"_2578":4447},{"_2580":4448},{"_7":244,"_245":246,"_247":4449,"_249":4450},[255],{"_255":4451},{"_7":268,"_271":4452},[2591],{"_2578":4454},{"_2580":4455},{"_452":2582},{"_2578":4457},{"_2580":4458},{"_452":2582},{"_2578":4460},{"_2580":4461},{"_452":2582},"A line names a comprobante this API holds that cannot be reported or withdrawn. AFFECTED_DOCUMENT_NOT_REGISTERED: its submission state is neither ACCEPTED nor OBSERVED, so send it to SUNAT first (SUNAT ERROR 2105 / 2398). AFFECTED_DOCUMENT_ALREADY_VOIDED: it was already withdrawn by a communication SUNAT accepted, which is permanent and has no remedy (SUNAT ERROR 2323 / 2987). AFFECTED_DOCUMENT_VOID_IN_FLIGHT: another baja holds it, or one ended AMBIGUOUS — wait for that communication to settle, and if it is rejected the comprobante is withdrawable again; never send a second baja. AFFECTED_DOCUMENT_ALREADY_REPORTED: another resumen diario already carries it, so look at that summary (SUNAT ERROR 2282). A line naming a comprobante this API does not hold is never refused here.",{"_2578":4464},{"_2580":4465},{"_452":2582},"Authenticated credential lacks documents:create",{"_2578":4468},{"_2580":4469},{"_452":2582},{"_2578":4474},{"_4075":4472},{"_2580":4473},{"_7":268},{"_2580":4475},{"_452":2582},{"_2578":4477},{"_2580":4478},{"_452":2582},"void communication (RA) created in VALIDATED state",{"_2609":4484},{"_2578":4482},{"_2580":4483},{"_452":4367},{"_2580":4485},{"_7":268,"_269":270},{"_2609":4490},{"_2578":4488},{"_2580":4489},{"_452":4367},{"_2580":4491},{"_7":268,"_269":270},{"_2578":4493},{"_2580":4494,"_1663":4495},{"_452":4502},{"_1338":4496},{"_3007":4497},{"_251":1343,"_429":1512,"_1205":4103,"_1473":4103,"_1475":1612,"_1547":4498,"_1549":4499},{"_429":1450,"_1422":4119,"_367":4120},[4500],{"_429":455,"_431":4109,"_433":4110,"_1579":4501},"ERROR EN EL IMPORTE UNITARIO","#/components/schemas/CreateVoidedCommunicationRequest",{"_2240":3014,"_2613":3015,"_247":23,"_2580":4504},{"_7":268,"_732":447,"_632":634},{"_2464":4506},[],{"_29":4508,"_427":4509,"_1019":4510,"_11":4511,"_2556":4512,"_2558":2433,"_2559":4513,"_2561":4514},[4377],"requestSummarySubmission","Durably request daily summary (RC) dispatch","Builds the SummaryDocuments UBL from the stored canonical payload, signs it, packages it and dispatches it with sendSummary, all inside a private durable Workflow. sendSummary answers with a ticket rather than a CDR, so the operation stays in TICKET_PENDING until getStatus resolves it. A dispatch whose ticket is lost is terminal and AMBIGUOUS: it is never resent automatically.",[4563],[4559,4560],{"_2563":4515,"_3324":4516,"_2806":4517,"_2565":4518,"_2567":4519,"_2569":4520,"_2868":4521,"_2571":4522,"_2573":4523,"_2635":4524},{"_11":3969,"_2576":4556},{"_11":3964,"_2576":4553},{"_11":2575,"_2576":4550},{"_11":2575,"_2576":4547},{"_11":3954,"_2576":4544},{"_11":2575,"_2576":4541},{"_11":2575,"_2576":4538},{"_11":2583,"_2576":4531},{"_11":2575,"_2576":4528},{"_11":3933,"_2576":4525},{"_2578":4526},{"_2580":4527},{"_452":2582},{"_2578":4529},{"_2580":4530},{"_452":2582},{"_2578":4532},{"_2580":4533},{"_7":244,"_245":246,"_247":4534,"_249":4535},[255],{"_255":4536},{"_7":268,"_271":4537},[2591],{"_2578":4539},{"_2580":4540},{"_452":2582},{"_2578":4542},{"_2580":4543},{"_452":2582},{"_2578":4545},{"_2580":4546},{"_452":2582},{"_2578":4548},{"_2580":4549},{"_452":2582},{"_2578":4551},{"_2580":4552},{"_452":2582},{"_2578":4554},{"_2580":4555},{"_452":4367},{"_2578":4557},{"_2580":4558},{"_452":4367},{"_2240":468,"_2613":27,"_247":23,"_2580":4562},{"_2240":3014,"_2613":3015,"_247":23,"_2580":4561},{"_7":268,"_732":447,"_632":634},{"_7":268,"_269":270},{"_2464":4564},[],{"_29":4566,"_427":4567,"_1019":4568,"_11":4382,"_2556":4569,"_2558":2432,"_2559":4570,"_2561":4571},[4377],"getSummary","Get a tenant-owned daily summary (RC) and its ticket operation",[4605],[4603],{"_2563":4572,"_2565":4573,"_2567":4574,"_2569":4575,"_2571":4576,"_2573":4577},{"_11":4411,"_2603":4597,"_2576":4598},{"_11":2575,"_2576":4594},{"_11":4007,"_2576":4591},{"_11":2575,"_2576":4588},{"_11":2583,"_2576":4581},{"_11":2575,"_2576":4578},{"_2578":4579},{"_2580":4580},{"_452":2582},{"_2578":4582},{"_2580":4583},{"_7":244,"_245":246,"_247":4584,"_249":4585},[255],{"_255":4586},{"_7":268,"_271":4587},[2591],{"_2578":4589},{"_2580":4590},{"_452":2582},{"_2578":4592},{"_2580":4593},{"_452":2582},{"_2578":4595},{"_2580":4596},{"_452":2582},{"_2609":4601},{"_2578":4599},{"_2580":4600},{"_452":4416},{"_2580":4602},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":4604},{"_7":268,"_269":270},{"_2464":4606},[],{"_29":4608,"_427":4609,"_1019":4610,"_11":4611,"_2556":4612,"_2558":2430,"_2559":4613,"_2941":4614,"_2561":4615},[4377],"createSummary","Validate and durably create a daily summary (RC)","A daily summary (RC) reports the boletas issued on one day and the notes that affect them, and it is the only way to annul a boleta: a line with statusCode 3, never a void communication. Creation is capability-gated per tenant and does not contact SUNAT. A line naming a comprobante this API holds is checked against it: the comprobante must have been accepted or observed by SUNAT, and must not already be withdrawn or carried by another live communication. A line naming a comprobante this API does not hold is accepted and recorded as unlinked — see `references` — because an emitter may have issued it through another provider, on paper, or before integrating; SUNAT's own ERROR 2105 and 2323 police that case.",[4700],[4698],{"_247":23,"_2576":4674},{"_2563":4616,"_2944":4617,"_2806":4618,"_2565":4619,"_2567":4620,"_2868":4621,"_2870":4622,"_2872":4623,"_2629":4624,"_2571":4625,"_2573":4626},{"_11":3969,"_2603":4668,"_2576":4669},{"_11":4661,"_2603":4662,"_2576":4663},{"_11":2575,"_2576":4658},{"_11":4072,"_2576":4652,"_2603":4653},{"_11":4466,"_2576":4649},{"_11":4462,"_2576":4646},{"_11":2575,"_2576":4643},{"_11":2575,"_2576":4640},{"_11":2575,"_2576":4637},{"_11":2583,"_2576":4630},{"_11":2575,"_2576":4627},{"_2578":4628},{"_2580":4629},{"_452":2582},{"_2578":4631},{"_2580":4632},{"_7":244,"_245":246,"_247":4633,"_249":4634},[255],{"_255":4635},{"_7":268,"_271":4636},[2591],{"_2578":4638},{"_2580":4639},{"_452":2582},{"_2578":4641},{"_2580":4642},{"_452":2582},{"_2578":4644},{"_2580":4645},{"_452":2582},{"_2578":4647},{"_2580":4648},{"_452":2582},{"_2578":4650},{"_2580":4651},{"_452":2582},{"_2578":4656},{"_4075":4654},{"_2580":4655},{"_7":268},{"_2580":4657},{"_452":2582},{"_2578":4659},{"_2580":4660},{"_452":2582},"daily summary (RC) created in VALIDATED state",{"_2609":4666},{"_2578":4664},{"_2580":4665},{"_452":4367},{"_2580":4667},{"_7":268,"_269":270},{"_2609":4672},{"_2578":4670},{"_2580":4671},{"_452":4367},{"_2580":4673},{"_7":268,"_269":270},{"_2578":4675},{"_2580":4676,"_1663":4677},{"_452":4697},{"_1338":4678},{"_3007":4679},{"_251":1343,"_429":1511,"_1205":4103,"_1473":4103,"_1475":1612,"_1547":4680,"_1549":4681},{"_429":1450,"_1422":4119,"_367":4120},[4682,4683],{"_429":456,"_431":4684,"_433":1612,"_1589":1612,"_317":1337,"_1373":4692,"_1595":4693,"_1597":4694},{"_429":456,"_431":4684,"_433":1613,"_1589":1612,"_317":1337,"_1592":4685,"_1373":4686,"_1595":4687,"_1597":4688},"B002",{"_429":1612,"_1422":4691},"826.00",{"_1627":4690},{"_1638":4689},"126.00","700.00","45678912","59.00",{"_1627":4696},{"_1638":4695},"9.00","50.00","#/components/schemas/CreateSummaryRequest",{"_2240":3014,"_2613":3015,"_247":23,"_2580":4699},{"_7":268,"_732":447,"_632":634},{"_2464":4701},[],{"_29":4703,"_427":4704,"_1019":4705,"_2556":4706,"_2558":2425,"_2559":4707,"_2561":4708},[4762],"downloadPdfRepresentation","Download an immutable versioned PDF representation",[4760],[4753,4754,4755],{"_2563":4709,"_2806":4710,"_2565":4711,"_2567":4712,"_2569":4713,"_2868":4714,"_2571":4715,"_2573":4716,"_2635":4717},{"_11":4747,"_2576":4748},{"_11":2575,"_2576":4744},{"_11":2575,"_2576":4741},{"_11":4737,"_2576":4738},{"_11":2575,"_2576":4734},{"_11":2575,"_2576":4731},{"_11":2583,"_2576":4724},{"_11":2575,"_2576":4721},{"_11":2575,"_2576":4718},{"_2578":4719},{"_2580":4720},{"_452":2582},{"_2578":4722},{"_2580":4723},{"_452":2582},{"_2578":4725},{"_2580":4726},{"_7":244,"_245":246,"_247":4727,"_249":4728},[255],{"_255":4729},{"_7":268,"_271":4730},[2591],{"_2578":4732},{"_2580":4733},{"_452":2582},{"_2578":4735},{"_2580":4736},{"_452":2582},"Authenticated credential lacks artifacts:read",{"_2578":4739},{"_2580":4740},{"_452":2582},{"_2578":4742},{"_2580":4743},{"_452":2582},{"_2578":4745},{"_2580":4746},{"_452":2582},"Integrity-checked immutable PDF stream",{"_880":4749},{"_2580":4750},{"_7":268,"_4751":4752},"contentMediaType","application/octet-stream",{"_2240":468,"_2613":27,"_247":23,"_2580":4759},{"_2240":441,"_2613":27,"_247":23,"_2580":4758},{"_2240":443,"_2613":27,"_247":23,"_2580":4756},{"_7":268,"_271":4757},[449,450],{"_7":268,"_269":270},{"_7":268,"_269":270},{"_2464":4761},[],"Artifacts",{"_29":4764,"_427":4765,"_1019":4766,"_11":4767,"_2556":4768,"_2558":2425,"_2559":4769,"_2561":4770},[4762],"downloadDocumentArtifact","Stream and integrity-check a public document artifact","Streams immutable bytes through a private R2-only service after tenant authorization and metadata integrity checks. Range requests are not supported.",[4840],[4835,4836],{"_2563":4771,"_2806":4772,"_2565":4773,"_2567":4774,"_2569":4775,"_2868":4776,"_2571":4777,"_2573":4778,"_2635":4779},{"_11":4808,"_2603":4809,"_2576":4810},{"_11":2575,"_2576":4805},{"_11":2575,"_2576":4802},{"_11":4737,"_2576":4799},{"_11":2575,"_2576":4796},{"_11":2575,"_2576":4793},{"_11":2583,"_2576":4786},{"_11":2575,"_2576":4783},{"_11":2575,"_2576":4780},{"_2578":4781},{"_2580":4782},{"_452":2582},{"_2578":4784},{"_2580":4785},{"_452":2582},{"_2578":4787},{"_2580":4788},{"_7":244,"_245":246,"_247":4789,"_249":4790},[255],{"_255":4791},{"_7":268,"_271":4792},[2591],{"_2578":4794},{"_2580":4795},{"_452":2582},{"_2578":4797},{"_2580":4798},{"_452":2582},{"_2578":4800},{"_2580":4801},{"_452":2582},{"_2578":4803},{"_2580":4804},{"_452":2582},{"_2578":4806},{"_2580":4807},{"_452":2582},"Integrity-checked artifact stream",{"_4819":4820,"_4821":4822,"_4823":4824,"_4825":4826,"_2609":4827},{"_878":4811,"_879":4812,"_880":4813,"_881":4814},{"_2580":4818},{"_2580":4817},{"_2580":4816},{"_2580":4815},{"_7":268,"_4751":4752},{"_7":268,"_4751":4752},{"_7":268,"_4751":4752},{"_7":268,"_4751":4752},"Cache-Control",{"_2580":4832},"Content-Digest",{"_2580":4831},"Content-Disposition",{"_2580":4830},"Content-Length",{"_2580":4829},{"_2580":4828},{"_7":268,"_269":270},{"_7":333,"_334":335},{"_7":268},{"_7":268},{"_7":268,"_271":4833},[4834],"private, no-store",{"_2240":468,"_2613":27,"_247":23,"_2580":4839},{"_2240":443,"_2613":27,"_247":23,"_2580":4837},{"_7":268,"_271":4838},[885,886,887,888,449,450,889],{"_7":268,"_269":270},{"_2464":4841},[],{"_29":4843,"_427":4844,"_1019":4845,"_11":4846,"_2556":4847,"_2558":2425,"_2559":4848,"_2561":4849},[4762],"listDocumentArtifacts","List public artifacts for a tenant-owned document","Returns safe metadata only. Internal object keys, HTML render inputs and unsigned XML are never exposed.",[4899],[4891,4892,4893],{"_2563":4850,"_2806":4851,"_2565":4852,"_2567":4853,"_2569":4854,"_2571":4855,"_2573":4856},{"_11":4879,"_2603":4880,"_2576":4881},{"_11":2575,"_2576":4876},{"_11":2575,"_2576":4873},{"_11":4737,"_2576":4870},{"_11":2575,"_2576":4867},{"_11":2583,"_2576":4860},{"_11":2575,"_2576":4857},{"_2578":4858},{"_2580":4859},{"_452":2582},{"_2578":4861},{"_2580":4862},{"_7":244,"_245":246,"_247":4863,"_249":4864},[255],{"_255":4865},{"_7":268,"_271":4866},[2591],{"_2578":4868},{"_2580":4869},{"_452":2582},{"_2578":4871},{"_2580":4872},{"_452":2582},{"_2578":4874},{"_2580":4875},{"_452":2582},{"_2578":4877},{"_2580":4878},{"_452":2582},"Public artifact metadata",{"_2609":4889},{"_2578":4882},{"_2580":4883},{"_944":4884},[4885,4886],{"_452":4888},{"_452":4887},"#/components/schemas/PaginatedArtifactListResponse","#/components/schemas/ArtifactListResponse",{"_2580":4890},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":4898},{"_2240":4896,"_2613":2736,"_247":246,"_2580":4897},{"_2240":4894,"_2613":2736,"_247":246,"_2580":4895},"representationCursor",{"_7":268,"_732":447,"_632":737},"representationLimit",{"_7":333,"_334":447,"_919":978},{"_7":268,"_269":270},{"_2464":4900},[],{"_29":4902,"_427":4903,"_1019":4904,"_11":4905,"_2556":4906,"_2558":2431,"_2559":4907,"_2941":4908,"_2561":4909},[4762],"requestPdfGeneration","Durably request immutable PDF representations","Pins canonical and signed-XML sources plus explicit template/renderer versions. Generation is asynchronous and never changes fiscal document state. Admission is limited to factura 01 and boleta 03; a 07 or 08 note obtains its QR and representations from its own accepted or observed submission.",[4979],[4975,4976],{"_247":23,"_2576":4965},{"_2563":4910,"_3324":4911,"_2806":4912,"_2565":4913,"_2567":4914,"_2569":4915,"_2868":4916,"_2870":4917,"_2872":4918,"_2629":4919,"_2571":4920,"_2573":4921},{"_11":3969,"_2576":4962},{"_11":4957,"_2576":4958},{"_11":2575,"_2576":4954},{"_11":2575,"_2576":4951},{"_11":4947,"_2576":4948},{"_11":2575,"_2576":4944},{"_11":2575,"_2576":4941},{"_11":2575,"_2576":4938},{"_11":2575,"_2576":4935},{"_11":2575,"_2576":4932},{"_11":2583,"_2576":4925},{"_11":2575,"_2576":4922},{"_2578":4923},{"_2580":4924},{"_452":2582},{"_2578":4926},{"_2580":4927},{"_7":244,"_245":246,"_247":4928,"_249":4929},[255],{"_255":4930},{"_7":268,"_271":4931},[2591],{"_2578":4933},{"_2580":4934},{"_452":2582},{"_2578":4936},{"_2580":4937},{"_452":2582},{"_2578":4939},{"_2580":4940},{"_452":2582},{"_2578":4942},{"_2580":4943},{"_452":2582},{"_2578":4945},{"_2580":4946},{"_452":2582},"Authenticated credential lacks documents:pdf",{"_2578":4949},{"_2580":4950},{"_452":2582},{"_2578":4952},{"_2580":4953},{"_452":2582},{"_2578":4955},{"_2580":4956},{"_452":2582},"PDF generation durably accepted",{"_2578":4959},{"_2580":4960},{"_452":4961},"#/components/schemas/PdfGenerationResponse",{"_2578":4963},{"_2580":4964},{"_452":4961},{"_2578":4966},{"_2580":4967,"_1663":4968},{"_452":4974},{"_1338":4969},{"_3007":4970},{"_251":273,"_941":4971},[4972,4973],{"_443":449,"_896":915},{"_443":450,"_896":916},"#/components/schemas/GeneratePdfRequest",{"_2240":468,"_2613":27,"_247":23,"_2580":4978},{"_2240":3014,"_2613":3015,"_247":23,"_2580":4977},{"_7":268,"_732":447,"_632":634},{"_7":268,"_269":270},{"_2464":4980},[],{"_29":4982,"_427":4983,"_1019":4984,"_11":4985,"_2556":4986,"_2558":2433,"_2559":4987,"_2561":4988},[5038],"requestDocumentSubmission","Durably request document submission","Creates an idempotent operation and outbox event. Factura, boleta and the restricted 07 and 08 note profiles are admitted only when their independent tenant capabilities are enabled: the capabilities are evaluated when the request arrives, and a request that does not meet them is REFUSED with 409 TENANT_CAPABILITY_DISABLED naming the exact capability column, never accepted and held. A 202 therefore means the submission is queued for the private SUNAT Workflow and will reach a terminal state; it never means the request is waiting for a capability to be turned on. A note profile is pinned per type and not per reason, so a 07 that voids its factura and a 07 that credits part of it are dispatched on identical terms. Successful admission does not imply SUNAT acceptance. An accepted or observed submission of any of these document types produces signed XML, submission ZIP, CDR, QR PNG and the A4 and ticket representations; a note prints its own series-number and amounts and names the document it modifies with its catalog 09/10 reason.",[5036],[5032,5033],{"_2563":4989,"_3324":4990,"_2806":4991,"_2565":4992,"_2567":4993,"_2569":4994,"_2868":4995,"_2571":4996,"_2573":4997},{"_11":3969,"_2576":5029},{"_11":5024,"_2576":5025},{"_11":2575,"_2576":5021},{"_11":2575,"_2576":5018},{"_11":3954,"_2576":5015},{"_11":2575,"_2576":5012},{"_11":5008,"_2576":5009},{"_11":2583,"_2576":5001},{"_11":2575,"_2576":4998},{"_2578":4999},{"_2580":5000},{"_452":2582},{"_2578":5002},{"_2580":5003},{"_7":244,"_245":246,"_247":5004,"_249":5005},[255],{"_255":5006},{"_7":268,"_271":5007},[2591],"TENANT_CAPABILITY_DISABLED: a capability this company must have for this document type is off, and error.details lists every requirement of the act with its own verdict, each named by its exact PostgreSQL column — submission_publication_enabled for any type, plus boleta_submission_enabled, credit_note_submission_enabled or debit_note_submission_enabled for 03, 07 and 08. An administrator of the company enables it and the same request then succeeds; GET /api/v2/organizations/companies/{id} reports the current state of all nine. DOCUMENT_TYPE_NOT_SUBMITTABLE, DOCUMENT_NOT_SUBMITTABLE and SUBMISSION_ALREADY_PENDING are the other three: the type cannot be sent on this route, the document is not in a submittable state, or a submission of it is already in flight.",{"_2578":5010},{"_2580":5011},{"_452":2582},{"_2578":5013},{"_2580":5014},{"_452":2582},{"_2578":5016},{"_2580":5017},{"_452":2582},{"_2578":5019},{"_2580":5020},{"_452":2582},{"_2578":5022},{"_2580":5023},{"_452":2582},"Submission request durably accepted",{"_2578":5026},{"_2580":5027},{"_452":5028},"#/components/schemas/DocumentOperationResponse",{"_2578":5030},{"_2580":5031},{"_452":5028},{"_2240":468,"_2613":27,"_247":23,"_2580":5035},{"_2240":3014,"_2613":3015,"_247":23,"_2580":5034},{"_7":268,"_732":447,"_632":634},{"_7":268,"_269":270},{"_2464":5037},[],"Documents",{"_29":5040,"_427":5041,"_1019":5042,"_2556":5043,"_2558":2432,"_2559":5044,"_2561":5045},[5038],"getDocument","Get a tenant-owned document and its canonical state",[5081],[5079],{"_2563":5046,"_2565":5047,"_2567":5048,"_2569":5049,"_2571":5050,"_2573":5051},{"_11":5071,"_2603":5072,"_2576":5073},{"_11":2575,"_2576":5068},{"_11":4007,"_2576":5065},{"_11":2575,"_2576":5062},{"_11":2583,"_2576":5055},{"_11":2575,"_2576":5052},{"_2578":5053},{"_2580":5054},{"_452":2582},{"_2578":5056},{"_2580":5057},{"_7":244,"_245":246,"_247":5058,"_249":5059},[255],{"_255":5060},{"_7":268,"_271":5061},[2591],{"_2578":5063},{"_2580":5064},{"_452":2582},{"_2578":5066},{"_2580":5067},{"_452":2582},{"_2578":5069},{"_2580":5070},{"_452":2582},"Canonical document state",{"_2609":5077},{"_2578":5074},{"_2580":5075},{"_452":5076},"#/components/schemas/DocumentResponse",{"_2580":5078},{"_7":268,"_269":270},{"_2240":468,"_2613":27,"_247":23,"_2580":5080},{"_7":268,"_269":270},{"_2464":5082},[],{"_29":5084,"_427":5085,"_1019":5086,"_11":5087,"_2556":5088,"_2558":2434,"_2941":5089,"_2561":5090},[5038],"validateDocument","Ask what POST /api/v2/documents would answer, without creating anything","The development tool. It runs every check the create route runs and then throws the result away: no comprobante, no correlativo, no operation, no outbox event, no quota. Free, and rate limited to 60 requests per 60 seconds per credential — a limit about how OFTEN you ask, never about what you sent, which is why it is a 429 with an error envelope and never a verdict.\n\nIT CANNOT WRITE. Not 'it does not': the route holds a repository class with no writing method, and that method runs inside a PostgreSQL READ ONLY transaction, so every INSERT, UPDATE and DELETE inside it — including one a trigger would fire — is refused by the server. A dry-run flag on the create route was rejected for the obvious reason: the day somebody leaves it set, a real comprobante exists.\n\nIT ANSWERS 200 EVEN WHEN THE DOCUMENT IS INVALID. The verdict is `valid`, in the body, and the status says only whether the service could answer. That is the opposite of the rest of this API and it is on purpose: this is the one route you call in a loop while programming, where 'invalid' is the expected result, and most HTTP clients turn a 4xx into a thrown exception you would then have to catch and unwrap to read the list you asked for.\n\nfindings[0] IS THE ERROR THE CREATE ROUTE WOULD ANSWER WITH — same code, same status, same details, because both routes read one implementation of the taxonomy. The remaining findings are the problems it would only have reported on your NEXT attempt; collecting them is what removes the round trips. `totals` is present whenever the arithmetic closes, so you can compare the IGV, the payable amount, the detraction split and the derived Cuota identifiers against your own before you issue anything.\n\nNO Idempotency-Key. There is nothing to replay.\n\nTHE TWO THINGS IT DOES NOT ANSWER. It does not tell you whether YOUR CREDENTIAL may create the document: a credential holding only documents:validate is told valid: true here and refused with 403 there, which is the point of the separate scope. And two of the rules it reports are snapshots of shared state — the accumulated credit on the affected comprobante, and whether that comprobante already has a cancellation note — so a note created by another request between this answer and yours moves them. That is a race, not a disagreement.",[5156],{"_247":23,"_2576":5141},{"_2563":5091,"_2806":5092,"_2565":5093,"_2567":5094,"_2870":5095,"_2872":5096,"_2571":5097,"_2573":5098,"_2635":5099},{"_11":5133,"_2603":5134,"_2576":5135},{"_11":2575,"_2576":5130},{"_11":4072,"_2576":5124,"_2603":5125},{"_11":5120,"_2576":5121},{"_11":2575,"_2576":5117},{"_11":2575,"_2576":5114},{"_11":5107,"_2576":5108,"_2603":5109},{"_11":2575,"_2576":5104},{"_11":5100,"_2576":5101},"This deployment has no rate limiter bound (VALIDATION_RATE_LIMITER_UNCONFIGURED). The route fails closed rather than becoming an unmetered free endpoint; nothing else is affected.",{"_2578":5102},{"_2580":5103},{"_452":2582},{"_2578":5105},{"_2580":5106},{"_452":2582},"The per-credential validation rate limit. This route answers the ordinary error envelope with code VALIDATION_RATE_LIMITED and a Retry-After header, NOT the edge `rate_limit_exceeded` body the write routes publish, so a caller in a loop can tell 'you are asking too often' from 'your comprobante is invalid' without parsing a message.",{"_2578":5112},{"_2640":5110},{"_2580":5111},{"_7":333},{"_2580":5113},{"_452":2582},{"_2578":5115},{"_2580":5116},{"_452":2582},{"_2578":5118},{"_2580":5119},{"_452":2582},"Authenticated credential lacks documents:validate. documents:create does not imply it, exactly as it does not imply documents:submit.",{"_2578":5122},{"_2580":5123},{"_452":2582},{"_2578":5128},{"_4075":5126},{"_2580":5127},{"_7":268},{"_2580":5129},{"_452":2582},{"_2578":5131},{"_2580":5132},{"_452":2582},"The verdict. `valid: true` with an empty `findings` array, or `valid: false` with the problems in the order the create route would hit them. `totals` is present whenever the arithmetic closes — including for a document that is invalid for some other reason, because seeing the number is half the work of building a mapping — and absent only when the schema refused the body outright or the totals do not close.",{"_2609":5139},{"_2578":5136},{"_2580":5137},{"_452":5138},"#/components/schemas/DocumentValidationResponse",{"_2580":5140},{"_7":268,"_269":270},{"_2578":5142},{"_2580":5143,"_1663":5144},{"_452":5155},{"_1338":5145},{"_3007":5146},{"_251":1343,"_429":455,"_431":4109,"_433":4110,"_1205":4103,"_1317":5147,"_317":1337,"_1547":5148,"_1592":5149,"_1549":5150},"10:15:00",{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[5151],{"_1905":5152,"_11":5153,"_1920":2146,"_1922":1612,"_1924":5154,"_1926":1947},"SERV-001","Consultoria de implementacion - plan mensual","1000.00","#/components/schemas/CreateDocumentRequest",{"_2464":5157},[],{"_29":5159,"_427":5160,"_1019":5161,"_11":5162,"_2556":5163,"_2558":2430,"_2559":5164,"_2941":5165,"_2561":5166},[5038],"createDocument","Validate and durably create a canonical invoice, receipt or fiscal note","Rehearse a body against POST /api/v2/documents/validations first: it runs every check this route runs, answers 200 with the verdict and the computed totals, creates nothing and costs nothing. NEW: 422 DOCUMENT_ARITHMETIC_INVALID refuses the four arithmetic conditions no schema can express, because each needs the document totals — a line whose allowances exceed its own value, a global allowance exceeding the document total, an adjustment over a zero base, and a Credito schedule whose instalments do not settle what is pending (payableAmount, or the detraction's netPayableAmount under the SPOT). Those four were previously accepted here with 201 and failed for the first time during submission, on a comprobante that could no longer be withdrawn. Credit/debit note creation is capability-gated per tenant. Submission uses separate default-off capabilities and, once accepted or observed, produces the QR and the A4/ticket representations for every supported document type. On-demand versioned generation through POST /api/v2/documents/{id}/pdfs is still limited to 01 and 03. The series F000 and B000 are reserved for the platform and are refused with 422 INVALID_DOCUMENT on every document type, notes included: F000 is what the certificate activation probe issues on, and although that probe is not a document of this tenant's, SUNAT records it under this tenant's RUC — so a tenant-issued F000 would collide with a number SUNAT already holds. B000 is reserved beside it although nothing issues on it, because reserving the factura series and leaving its boleta twin free invites the next caller to reach for B000 as the obviously unused one.",[5390],[5388],{"_247":23,"_2576":5225},{"_2563":5167,"_2944":5168,"_2806":5169,"_2565":5170,"_2567":5171,"_2868":5172,"_2870":5173,"_2872":5174,"_2629":5175,"_2571":5176,"_2573":5177},{"_11":3969,"_2603":5219,"_2576":5220},{"_11":5212,"_2603":5213,"_2576":5214},{"_11":2575,"_2576":5209},{"_11":4072,"_2576":5203,"_2603":5204},{"_11":4466,"_2576":5200},{"_11":2575,"_2576":5197},{"_11":2575,"_2576":5194},{"_11":2575,"_2576":5191},{"_11":2575,"_2576":5188},{"_11":2583,"_2576":5181},{"_11":2575,"_2576":5178},{"_2578":5179},{"_2580":5180},{"_452":2582},{"_2578":5182},{"_2580":5183},{"_7":244,"_245":246,"_247":5184,"_249":5185},[255],{"_255":5186},{"_7":268,"_271":5187},[2591],{"_2578":5189},{"_2580":5190},{"_452":2582},{"_2578":5192},{"_2580":5193},{"_452":2582},{"_2578":5195},{"_2580":5196},{"_452":2582},{"_2578":5198},{"_2580":5199},{"_452":2582},{"_2578":5201},{"_2580":5202},{"_452":2582},{"_2578":5207},{"_4075":5205},{"_2580":5206},{"_7":268},{"_2580":5208},{"_452":2582},{"_2578":5210},{"_2580":5211},{"_452":2582},"Document created in VALIDATED state",{"_2609":5217},{"_2578":5215},{"_2580":5216},{"_452":5028},{"_2580":5218},{"_7":268,"_269":270},{"_2609":5223},{"_2578":5221},{"_2580":5222},{"_452":5028},{"_2580":5224},{"_7":268,"_269":270},{"_2578":5226},{"_2580":5227,"_1663":5228},{"_452":5155},{"_5229":5230,"_5231":5232,"_5233":5234,"_5235":5236,"_5237":5238,"_5239":5240,"_5241":5242,"_5243":5244,"_5245":5246,"_5247":5248,"_5249":5250,"_5251":5252},"facturaGravada",{"_1019":5382,"_3007":5383},"boletaConDni",{"_1019":5376,"_3007":5377},"boletaAnonima",{"_1019":5366,"_11":5367,"_3007":5368},"notaCreditoTotal",{"_1019":5357,"_11":5358,"_3007":5359},"notaCreditoParcial",{"_1019":5345,"_11":5346,"_3007":5347},"notaCreditoSobreBoleta",{"_1019":5336,"_3007":5337},"notaDebito",{"_1019":5324,"_3007":5325},"facturaConDetraccion",{"_1019":5311,"_3007":5312},"facturaAlCredito",{"_1019":5298,"_3007":5299},"facturaExportacion",{"_1019":5282,"_3007":5283},"boletaConIcbper",{"_1019":5264,"_3007":5265},"facturaConTransferenciaGratuita",{"_1019":5253,"_3007":5254},"Transferencia gratuita: afectacion 15 con igvRate explicito",{"_251":1343,"_429":455,"_431":4109,"_433":5255,"_1205":4103,"_1317":5147,"_317":1337,"_1547":5256,"_1592":5257,"_1549":5258},"1031",{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[5259,5260],{"_1905":5152,"_11":5153,"_1920":2146,"_1922":1612,"_1924":5154,"_1926":1947},{"_1905":5261,"_11":5262,"_1920":2141,"_1922":1612,"_1924":5263,"_1926":1951,"_1928":2138},"BON-001","Muestra comercial entregada sin cargo","80.00","Boleta con ICBPER: el impuesto va en la linea que lo soporta",{"_251":1343,"_429":456,"_431":5266,"_433":5267,"_1205":4103,"_1317":5268,"_317":1337,"_1547":5269,"_1592":5270,"_1549":5271},"B001","3312","18:40:00",{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1612,"_1422":4691,"_367":5281},[5272,5273],{"_1905":5278,"_11":5279,"_1920":2141,"_1922":1613,"_1924":5280,"_1926":1947},{"_1905":5274,"_11":5275,"_1920":2141,"_1922":1614,"_1924":5276,"_1926":1947,"_1930":5277},"BOL-001","Bolsa plastica","0.10","0.50","PROD-001","Polo de algodon talla M","25.00","MARIA FERNANDA QUISPE ROJAS","Exportacion: afectacion 40, adquirente no domiciliado y USD",{"_251":1343,"_429":455,"_431":4109,"_433":5284,"_1205":4103,"_317":1717,"_1002":5285,"_1547":5286,"_1592":5287,"_1549":5288},"1029","0200",{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1751,"_1422":5294,"_367":5295,"_1427":5296,"_1431":5297},[5289],{"_1905":5290,"_11":5291,"_1920":2142,"_1922":5292,"_1924":5293,"_1926":1254},"EXP-001","Cafe verde arabica en sacos de 60 kg","600","4.50","AB1234567","GLOBAL TRADING LLC","US","1200 BRICKELL AVE, MIAMI FL","Factura al credito: paymentMethod y el calendario de cuotas",{"_251":1343,"_429":455,"_431":4109,"_433":5300,"_1205":4103,"_1317":5147,"_317":1337,"_1547":5301,"_1592":5302,"_1549":5303,"_1677":1713,"_1147":5304},"1028",{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[5310],[5305,5306],{"_1153":5307,"_1155":5309},{"_1153":5307,"_1155":5308},"590.00","2026-10-11","2026-09-11",{"_1905":5152,"_11":5153,"_1920":2146,"_1922":1612,"_1924":5154,"_1926":1947},"Factura con detraccion (SPOT), con su operationType 1001",{"_251":1343,"_429":455,"_431":4109,"_433":5313,"_1205":4103,"_1317":5147,"_317":1337,"_1547":5314,"_1592":5315,"_1549":5316,"_1002":5317,"_1138":5318},"1027",{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[5320],"1001",{"_259":5319,"_1162":1750,"_1880":1889,"_1882":1885},"027",{"_1905":5321,"_11":5322,"_1920":2146,"_1922":1612,"_1924":5323,"_1926":1947},"TRA-001","Servicio de transporte de carga Lima - Arequipa","5000.00","Nota de debito 08 catalogo 10 03",{"_251":1343,"_429":458,"_431":5326,"_433":1751,"_1205":4103,"_317":1337,"_1680":456,"_1599":5327,"_1547":5328,"_1592":5329,"_1549":5330},"FD01",{"_429":455,"_431":4109,"_433":5335},{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[5331],{"_1905":5332,"_11":5333,"_1920":2146,"_1922":1612,"_1924":5334,"_1926":1947},"PEN-001","Penalidad por incumplimiento de plazo contractual","100.00","1026","Nota de credito 07 sobre una boleta 03: serie B, adquirente de la boleta",{"_251":1343,"_429":457,"_431":5338,"_433":1750,"_1205":4103,"_317":1337,"_1680":455,"_1599":5339,"_1547":5340,"_1592":5341,"_1549":5342},"BC01",{"_429":456,"_431":5266,"_433":5344},{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1612,"_1422":4691,"_367":5281},[5343],{"_1905":5278,"_11":5279,"_1920":2141,"_1922":1613,"_1924":5280,"_1926":1947},"3310","Nota de credito 07 catalogo 09 09: acredita parte de la factura","Los codigos 04, 05, 07, 08 y 09 llevan lineas propias. El credito acumulado contra una factura no puede superar su total: la nota que lo sobrepasa se rechaza con 409 AFFECTED_FACTURA_CREDIT_EXCEEDED.",{"_251":1343,"_429":457,"_431":5348,"_433":5349,"_1205":4103,"_317":1337,"_1680":1705,"_1599":5350,"_1547":5351,"_1592":5352,"_1549":5353},"FC01","19",{"_429":455,"_431":4109,"_433":5335},{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[5354],{"_1905":5152,"_11":5355,"_1920":2146,"_1922":1612,"_1924":5356,"_1926":1947},"Disminucion en el valor - descuento comercial acordado","200.00","Nota de credito 07 catalogo 09 01: anula la factura entera","Los codigos 01, 02, 03 y 06 anulan: reproducen las lineas y los totales del comprobante afectado, y solo se admite una por factura.",{"_251":1343,"_429":457,"_431":5348,"_433":2138,"_1205":4103,"_317":1337,"_1680":455,"_1599":5360,"_1547":5361,"_1592":5362,"_1549":5363},{"_429":455,"_431":4109,"_433":5365},{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[5364],{"_1905":5152,"_11":5153,"_1920":2146,"_1922":1612,"_1924":5154,"_1926":1947},"1025","Boleta 03 anonima: catalogo 06 0 con documentNumber '-'","La venta de mostrador que no identifica a nadie, legal hasta un total de PEN 700.00 (SUNAT 2514). Es el perfil que menos se adivina y el que el documento publicado llego a declarar imposible.",{"_251":1343,"_429":456,"_431":5266,"_433":5369,"_1205":4103,"_1317":5268,"_317":1337,"_1547":5370,"_1592":5371,"_1549":5372},"3311",{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1749,"_1422":5374,"_367":5375},[5373],{"_1905":5278,"_11":5279,"_1920":2141,"_1922":1613,"_1924":5280,"_1926":1947},"-","CLIENTES VARIOS","Boleta 03 con adquirente identificado por DNI (catalogo 06 1)",{"_251":1343,"_429":456,"_431":5266,"_433":5344,"_1205":4103,"_1317":5268,"_317":1337,"_1547":5378,"_1592":5379,"_1549":5380},{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1612,"_1422":4691,"_367":5281},[5381],{"_1905":5278,"_11":5279,"_1920":2141,"_1922":1613,"_1924":5280,"_1926":1947},"Factura 01 gravada, la venta domestica ordinaria",{"_251":1343,"_429":455,"_431":4109,"_433":4110,"_1205":4103,"_1317":5147,"_317":1337,"_1547":5384,"_1592":5385,"_1549":5386},{"_429":1450,"_1422":4119,"_367":4120,"_1431":4121,"_1429":4122,"_1433":4123,"_1435":4118,"_1437":4118},{"_429":1450,"_1422":4113,"_367":4114,"_1431":4115,"_1429":4116,"_1433":4117,"_1435":4118,"_1437":4118},[5387],{"_1905":5152,"_11":5153,"_1920":2146,"_1922":1612,"_1924":5154,"_1926":1947},{"_2240":3014,"_2613":3015,"_247":23,"_2580":5389},{"_7":268,"_732":447,"_632":634},{"_2464":5391},[],{"_29":5393,"_427":5394,"_1019":5395,"_5396":23,"_11":5397,"_2556":5398,"_2558":2431,"_2559":5399,"_2941":5400,"_2561":5401},[5473],"generateLegacyInvoiceTicket","Durably request an immutable ticket representation","deprecated","Safe asynchronous compatibility route. Requires documents:pdf; unsupported legacy fields are rejected.",[5471],[5468],{"_247":23,"_2576":5459},{"_2563":5402,"_3324":5403,"_2806":5404,"_2565":5405,"_2567":5406,"_2569":5407,"_2868":5408,"_2870":5409,"_2872":5410,"_2629":5411,"_2571":5412,"_2573":5413},{"_11":5455,"_2576":5456},{"_11":5450,"_2576":5451},{"_11":5414,"_2576":5447},{"_11":5414,"_2576":5444},{"_11":5414,"_2576":5441},{"_11":5414,"_2576":5438},{"_11":5414,"_2576":5435},{"_11":5414,"_2576":5432},{"_11":5414,"_2576":5429},{"_11":5414,"_2576":5426},{"_11":2583,"_2576":5419},{"_11":5414,"_2576":5415},"Legacy compatibility error envelope",{"_2578":5416},{"_2580":5417},{"_452":5418},"#/components/schemas/LegacyErrorEnvelope",{"_2578":5420},{"_2580":5421},{"_7":244,"_245":246,"_247":5422,"_249":5423},[255],{"_255":5424},{"_7":268,"_271":5425},[2591],{"_2578":5427},{"_2580":5428},{"_452":5418},{"_2578":5430},{"_2580":5431},{"_452":5418},{"_2578":5433},{"_2580":5434},{"_452":5418},{"_2578":5436},{"_2580":5437},{"_452":5418},{"_2578":5439},{"_2580":5440},{"_452":5418},{"_2578":5442},{"_2580":5443},{"_452":5418},{"_2578":5445},{"_2580":5446},{"_452":5418},{"_2578":5448},{"_2580":5449},{"_452":5418},"Operation accepted",{"_2578":5452},{"_2580":5453},{"_452":5454},"#/components/schemas/LegacyInvoiceResponse","Idempotent replay or operation status poll",{"_2578":5457},{"_2580":5458},{"_452":5454},{"_2578":5460},{"_2580":5461,"_1663":5462},{"_452":5467},{"_1338":5463},{"_3007":5464},{"_2066":5465},{"_2074":455,"_2076":4109,"_2085":5466},"1030","#/components/schemas/LegacyInvoiceReferenceRequest",{"_2240":3014,"_2613":3015,"_247":246,"_11":5469,"_2580":5470},"Optional. A deterministic document-identity key is derived when omitted.",{"_7":268,"_732":447,"_632":634,"_309":734},{"_2464":5472},[],"Legacy compatibility",{"_29":5475,"_427":5476,"_1019":5477,"_5396":23,"_11":5397,"_2556":5478,"_2558":2431,"_2559":5479,"_2941":5480,"_2561":5481},[5473],"generateLegacyInvoiceA4","Durably request an immutable A4 representation",[5543],[5541],{"_247":23,"_2576":5534},{"_2563":5482,"_3324":5483,"_2806":5484,"_2565":5485,"_2567":5486,"_2569":5487,"_2868":5488,"_2870":5489,"_2872":5490,"_2629":5491,"_2571":5492,"_2573":5493},{"_11":5455,"_2576":5531},{"_11":5450,"_2576":5528},{"_11":5414,"_2576":5525},{"_11":5414,"_2576":5522},{"_11":5414,"_2576":5519},{"_11":5414,"_2576":5516},{"_11":5414,"_2576":5513},{"_11":5414,"_2576":5510},{"_11":5414,"_2576":5507},{"_11":5414,"_2576":5504},{"_11":2583,"_2576":5497},{"_11":5414,"_2576":5494},{"_2578":5495},{"_2580":5496},{"_452":5418},{"_2578":5498},{"_2580":5499},{"_7":244,"_245":246,"_247":5500,"_249":5501},[255],{"_255":5502},{"_7":268,"_271":5503},[2591],{"_2578":5505},{"_2580":5506},{"_452":5418},{"_2578":5508},{"_2580":5509},{"_452":5418},{"_2578":5511},{"_2580":5512},{"_452":5418},{"_2578":5514},{"_2580":5515},{"_452":5418},{"_2578":5517},{"_2580":5518},{"_452":5418},{"_2578":5520},{"_2580":5521},{"_452":5418},{"_2578":5523},{"_2580":5524},{"_452":5418},{"_2578":5526},{"_2580":5527},{"_452":5418},{"_2578":5529},{"_2580":5530},{"_452":5454},{"_2578":5532},{"_2580":5533},{"_452":5454},{"_2578":5535},{"_2580":5536,"_1663":5537},{"_452":5467},{"_1338":5538},{"_3007":5539},{"_2066":5540},{"_2074":455,"_2076":4109,"_2085":5466},{"_2240":3014,"_2613":3015,"_247":246,"_11":5469,"_2580":5542},{"_7":268,"_732":447,"_632":634,"_309":734},{"_2464":5544},[],{"_29":5546,"_427":5547,"_1019":5548,"_5396":23,"_11":5549,"_2556":5550,"_2558":2433,"_2559":5551,"_2941":5552,"_2561":5553},[5473],"submitLegacyInvoice","Durably request SUNAT submission for a legacy document identity","Safe asynchronous compatibility route. Requires documents:submit; unsupported legacy fields are rejected.",[5615],[5613],{"_247":23,"_2576":5606},{"_2563":5554,"_3324":5555,"_2806":5556,"_2565":5557,"_2567":5558,"_2569":5559,"_2868":5560,"_2870":5561,"_2872":5562,"_2629":5563,"_2571":5564,"_2573":5565},{"_11":5455,"_2576":5603},{"_11":5450,"_2576":5600},{"_11":5414,"_2576":5597},{"_11":5414,"_2576":5594},{"_11":5414,"_2576":5591},{"_11":5414,"_2576":5588},{"_11":5414,"_2576":5585},{"_11":5414,"_2576":5582},{"_11":5414,"_2576":5579},{"_11":5414,"_2576":5576},{"_11":2583,"_2576":5569},{"_11":5414,"_2576":5566},{"_2578":5567},{"_2580":5568},{"_452":5418},{"_2578":5570},{"_2580":5571},{"_7":244,"_245":246,"_247":5572,"_249":5573},[255],{"_255":5574},{"_7":268,"_271":5575},[2591],{"_2578":5577},{"_2580":5578},{"_452":5418},{"_2578":5580},{"_2580":5581},{"_452":5418},{"_2578":5583},{"_2580":5584},{"_452":5418},{"_2578":5586},{"_2580":5587},{"_452":5418},{"_2578":5589},{"_2580":5590},{"_452":5418},{"_2578":5592},{"_2580":5593},{"_452":5418},{"_2578":5595},{"_2580":5596},{"_452":5418},{"_2578":5598},{"_2580":5599},{"_452":5418},{"_2578":5601},{"_2580":5602},{"_452":5454},{"_2578":5604},{"_2580":5605},{"_452":5454},{"_2578":5607},{"_2580":5608,"_1663":5609},{"_452":5467},{"_1338":5610},{"_3007":5611},{"_2066":5612},{"_2074":455,"_2076":4109,"_2085":5466},{"_2240":3014,"_2613":3015,"_247":246,"_11":5469,"_2580":5614},{"_7":268,"_732":447,"_632":634,"_309":734},{"_2464":5616},[],{"_29":5618,"_427":5619,"_1019":5620,"_5396":23,"_11":5621,"_2556":5622,"_2558":2430,"_2559":5623,"_2941":5624,"_2561":5625},[5473],"createLegacyInvoice","Validate and store a legacy factura or boleta payload","Safe asynchronous compatibility route. Requires documents:create; unsupported legacy fields are rejected.",[5693],[5691],{"_247":23,"_2576":5679},{"_2563":5626,"_2944":5627,"_2806":5628,"_2565":5629,"_2567":5630,"_2569":5631,"_2868":5632,"_2870":5633,"_2872":5634,"_2629":5635,"_2571":5636,"_2573":5637},{"_11":5455,"_2576":5676},{"_11":5672,"_2576":5673},{"_11":5414,"_2576":5669},{"_11":5414,"_2576":5666},{"_11":5414,"_2576":5663},{"_11":5414,"_2576":5660},{"_11":5414,"_2576":5657},{"_11":5414,"_2576":5654},{"_11":5414,"_2576":5651},{"_11":5414,"_2576":5648},{"_11":2583,"_2576":5641},{"_11":5414,"_2576":5638},{"_2578":5639},{"_2580":5640},{"_452":5418},{"_2578":5642},{"_2580":5643},{"_7":244,"_245":246,"_247":5644,"_249":5645},[255],{"_255":5646},{"_7":268,"_271":5647},[2591],{"_2578":5649},{"_2580":5650},{"_452":5418},{"_2578":5652},{"_2580":5653},{"_452":5418},{"_2578":5655},{"_2580":5656},{"_452":5418},{"_2578":5658},{"_2580":5659},{"_452":5418},{"_2578":5661},{"_2580":5662},{"_452":5418},{"_2578":5664},{"_2580":5665},{"_452":5418},{"_2578":5667},{"_2580":5668},{"_452":5418},{"_2578":5670},{"_2580":5671},{"_452":5418},"Document created",{"_2578":5674},{"_2580":5675},{"_452":5454},{"_2578":5677},{"_2580":5678},{"_452":5454},{"_2578":5680},{"_2580":5681,"_1663":5682},{"_452":5690},{"_1338":5683},{"_3007":5684},{"_2066":5685,"_2095":5686,"_266":5687},{"_2184":1714,"_2074":455,"_2076":4109,"_2085":5466,"_2189":4103,"_2191":5689,"_2193":1337,"_2195":1711},{"_2074":1450,"_2099":4113,"_2162":4114,"_2164":1448,"_2166":4115},[5688],{"_2123":5152,"_2125":5153,"_2127":2146,"_2129":1612,"_2131":5154,"_2133":1947,"_2135":2138},"09:30:00","#/components/schemas/LegacyInvoiceCreateRequest",{"_2240":3014,"_2613":3015,"_247":246,"_11":5469,"_2580":5692},{"_7":268,"_732":447,"_632":634,"_309":734},{"_2464":5694},[],{"_29":5696,"_427":5697,"_2561":5698},[31],"getOpenApiV2",{"_2563":5699},{"_11":5700},"Bundled OpenAPI 3.0.3 document",{"_29":5702,"_427":5703,"_2561":5704},[31],"getHealth",{"_2563":5705},{"_11":5706,"_2576":5707},"Service health",{"_2578":5708},{"_2580":5709},{"_7":244,"_245":246,"_247":5710,"_249":5711},[369,5713,471,5716],{"_369":5712,"_5713":5714,"_471":5715,"_5716":5717},{"_7":268,"_271":5720},"phase",{"_7":268,"_271":5718},{"_7":268},"legacyV1AuthConfigured",{"_7":307},[5719],"phase2",[5721],"ok",{"_2240":31},{"_2240":5038},{"_2240":4377},{"_2240":3979},{"_2240":4762},{"_2240":2617},{"_2240":3630},{"_2240":3316},{"_2240":2854},{"_2240":2685},{"_2240":5473},{"_799":5737,"_11":5738},{"_799":5735,"_11":5736},"https://apifact-staging.fac-360.com","Staging. Issues against SUNAT beta, so nothing sent through it is fiscally valid and nothing costs anything. This is where an integration should be built and where the certificate activation probe is free.","https://apifact.fac-360.com","Production. Every accepted document here is a real comprobante: it enters the taxpayer's sales ledger and can only be withdrawn by an accepted comunicacion de baja. Requires a credential minted on this edge; a staging one answers 401.","Apifact API","2.0.0-alpha.27","Canonical multi-tenant API. Document creation validates and persists a document; it does not submit it to SUNAT.","$fumadocs_loader","page-tree",{"_7":5745,"_452":5746,"_5747":5745,"_2240":5748,"_11":-7,"_5749":5750},"root",{"_5770":6357,"_5778":6358},"$id","Documentación","children",[5751,5752,5753,5754,5755,5756,5757,5758,5759,5760,5761,5762,5763,5764,5765,5766,5767,5768,5769],{"_5747":6350,"_7":2225,"_2240":6351,"_11":6352,"_5777":-7,"_799":6353,"_452":6350},{"_5747":6343,"_7":2225,"_2240":6344,"_11":6345,"_5777":-7,"_799":6346,"_452":6343},{"_5747":6336,"_7":2225,"_2240":6337,"_11":6338,"_5777":-7,"_799":6339,"_452":6336},{"_5747":6331,"_7":5970,"_5777":-7,"_2240":6332},{"_7":5770,"_2240":6310,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":6311,"_5747":6312,"_452":6313,"_5777":-7},{"_7":5770,"_2240":6275,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":6276,"_5747":6277,"_452":6278,"_5777":-7},{"_7":5770,"_2240":6240,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":6241,"_5747":6242,"_452":6243,"_5777":-7},{"_7":5770,"_2240":6205,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":6206,"_5747":6207,"_452":6208,"_5777":-7},{"_7":5770,"_2240":6156,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":6157,"_5747":6158,"_452":6159,"_5777":-7},{"_7":5770,"_2240":6107,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":6108,"_5747":6109,"_452":6110,"_5777":-7},{"_7":5770,"_2240":6065,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":6066,"_5747":6067,"_452":6068,"_5777":-7},{"_7":5770,"_2240":3316,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":6024,"_5747":6025,"_452":6026,"_5777":-7},{"_7":5770,"_2240":2854,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":5996,"_5747":5997,"_452":5998,"_5777":-7},{"_7":5770,"_2240":2685,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":5980,"_5747":5981,"_452":5982,"_5777":-7},{"_7":5770,"_2240":2617,"_5745":-7,"_5771":-7,"_11":-7,"_5773":-7,"_5749":5972,"_5747":5973,"_452":5974,"_5777":-7},{"_5747":5969,"_7":5970,"_5777":-7,"_2240":5971},{"_7":5770,"_2240":5911,"_5745":-7,"_5771":-7,"_11":5912,"_5773":-7,"_5749":5913,"_5747":5914,"_452":5915,"_5777":-7},{"_7":5770,"_2240":5833,"_5745":-7,"_5771":-7,"_11":5834,"_5773":-7,"_5749":5835,"_5747":5836,"_452":5837,"_5777":-7},{"_7":5770,"_2240":2854,"_5745":-7,"_5771":-7,"_11":5772,"_5773":-7,"_5749":5774,"_5747":5775,"_452":5776,"_5777":-7},"folder","defaultOpen","Members, roles and invitations","collapsible",[5780,5781,5782,5783,5784,5785,5786,5787,5788,5789,5790],"console/organizations",{"_5770":5775,"_5778":5779},"icon","meta","console/organizations/meta.json",{"_5747":5830,"_7":2225,"_2240":5831,"_11":-7,"_5777":-7,"_799":5832,"_452":5830},{"_5747":5826,"_7":2225,"_2240":5827,"_11":5828,"_5777":-7,"_799":5829,"_452":5826},{"_5747":5823,"_7":2225,"_2240":5824,"_11":-7,"_5777":-7,"_799":5825,"_452":5823},{"_5747":5819,"_7":2225,"_2240":5820,"_11":5821,"_5777":-7,"_799":5822,"_452":5819},{"_5747":5815,"_7":2225,"_2240":5816,"_11":5817,"_5777":-7,"_799":5818,"_452":5815},{"_5747":5811,"_7":2225,"_2240":5812,"_11":5813,"_5777":-7,"_799":5814,"_452":5811},{"_5747":5807,"_7":2225,"_2240":5808,"_11":5809,"_5777":-7,"_799":5810,"_452":5807},{"_5747":5803,"_7":2225,"_2240":5804,"_11":5805,"_5777":-7,"_799":5806,"_452":5803},{"_5747":5799,"_7":2225,"_2240":5800,"_11":5801,"_5777":-7,"_799":5802,"_452":5799},{"_5747":5795,"_7":2225,"_2240":5796,"_11":5797,"_5777":-7,"_799":5798,"_452":5795},{"_5747":5791,"_7":2225,"_2240":5792,"_11":5793,"_5777":-7,"_799":5794,"_452":5791},"console/organizations/acceptConsoleInvitation.mdx","Accept an invitation POST POST","Requires a live session whose verified address is the one the invitation was sent to. Accepting with a different account would turn a leaked link into a way into someone else's organization. An invitation for somebody who is already a member is spent without changing the role they already have.","/docs/console/organizations/acceptConsoleInvitation","console/organizations/revokeConsoleInvitation.mdx","Withdraw an invitation DELETE DELETE","An invitation lives a week. Without this, an invitation sent to a mistyped address is live for all of it.","/docs/console/organizations/revokeConsoleInvitation","console/organizations/inviteConsoleMember.mdx","Invite somebody POST POST","ADMIN and above, and nobody may invite above their own rank: an ADMIN who could mint an OWNER is an ADMIN who can promote themselves through a second account. The invitation is bound to the address it names, so a forwarded link is worth nothing to anybody else.","/docs/console/organizations/inviteConsoleMember","console/organizations/listConsoleInvitations.mdx","Invitations sent and not yet spent GET GET","ADMIN and above, unlike the member list: a pending invitation names an address that belongs to nobody here yet.","/docs/console/organizations/listConsoleInvitations","console/organizations/revokeConsoleOrganizationCredential.mdx","Revoke an organization credential DELETE DELETE","Immediate, not at expiry: auth.assert_organization_credential re-reads revoked_at on every provisioning statement. Same OWNER floor as minting, never higher, AND DELIBERATELY WITHOUT THE SECOND FACTOR the mint requires. Revocation is the emergency action -- it is what somebody does at 2am with a secret in a public repository -- and the person reaching for the kill switch is the person whose phone may be the thing that was lost. Minting creates risk and carries the friction; revoking removes risk and carries none. Unknown, already revoked, and belonging to another organization are one 404.","/docs/console/organizations/revokeConsoleOrganizationCredential","console/organizations/mintConsoleOrganizationCredential.mdx","Mint an organization credential POST POST","OWNER, and an enrolled second factor. This is the credential a SaaS puts in a server to register its own client companies by API. THE FLOOR IS NOT ADMIN, and not by symmetry with anything: every other act an ADMIN performs lands inside their own organization, whereas companies:manage can register a company under ANY RUC in Peru, and core.companies.ruc is unique platform-wide, so claiming one DENIES it to whoever controls it -- a third party with no account here. SUNAT publishes no ownership oracle, so migration 000053's answer is attribution rather than prevention: every act writes an ops.audit_events row in the same transaction. A control whose whole mechanism is 'we can say who did it' belongs to the rank that can be held answerable. THE SECOND FACTOR IS CHECKED IN SQL, on auth.users.mfa_enrolled_at, because the failure this act invites is a stolen session -- which is by construction a caller of the correct rank, and would make the audit row name somebody who did nothing. Enrolment is self-service, so this strands nobody. THE TOKEN IS IN THE 201 AND NOWHERE ELSE.","/docs/console/organizations/mintConsoleOrganizationCredential","console/organizations/listConsoleOrganizationCredentials.mdx","The provisioning credentials of this organization GET GET","OWNER, and NOT VIEWER as the company credential listing is. That one is VIEWER because GET /console/v1/companies/{companyId}/activity already publishes every company credential's public prefix to every VIEWER, so hiding the list would be a rule with no content; nothing publishes an organization credential's prefix, because it issues nothing and so reaches no activity row. What is left is that this listing is the input to the revocation decision -- you revoke the row you are looking at -- and a list readable by somebody who cannot act on it splits an emergency across two people. It carries no secret: only a SHA-256 is stored. Revoked and expired credentials stay in it.","/docs/console/organizations/listConsoleOrganizationCredentials","console/organizations/createConsoleCompany.mdx","Register a company under this organization POST POST","ADMIN and above, which is ADR 0016 point 7's assignment of companies rather than this route's opinion. Nothing here proves the caller controls the RUC and nothing needs to: the claim confers nothing until a certificate this platform signed with has been accepted by SUNAT, which is proof of control checked by the party that can perform it. What the alta does guarantee is attribution -- it writes an ops.audit_events row naming the person, in the same transaction as the company -- so a squatted RUC is an operator action with evidence rather than an argument between two customers. Every refusal about WHO the caller is answers 409 MEMBERSHIP_CHANGE_REFUSED indistinguishably; only a RUC already registered answers something specific, and it says nothing about whose it is.","/docs/console/organizations/createConsoleCompany","console/organizations/removeConsoleMember.mdx","Remove a member DELETE DELETE","/docs/console/organizations/removeConsoleMember","console/organizations/setConsoleMemberRole.mdx","Change a member's role PATCH PATCH","OWNER only, and the last OWNER can be neither demoted nor removed. The affected member's sessions are revoked -- theirs alone, since a role change concerns one person and logging the whole team out would turn administration into an outage.","/docs/console/organizations/setConsoleMemberRole","console/organizations/listConsoleMembers.mdx","Who is in this organization GET GET","/docs/console/organizations/listConsoleMembers","Companies","The companies a session can operate, and their data",[5839,5840,5841,5842,5843,5844,5845,5846,5847,5848,5849,5850,5851,5852,5853],"console/companies",{"_5770":5836,"_5778":5838},"console/companies/meta.json",{"_5747":5907,"_7":2225,"_2240":5908,"_11":5909,"_5777":-7,"_799":5910,"_452":5907},{"_5747":5903,"_7":2225,"_2240":5904,"_11":5905,"_5777":-7,"_799":5906,"_452":5903},{"_5747":5900,"_7":2225,"_2240":5901,"_11":-7,"_5777":-7,"_799":5902,"_452":5900},{"_5747":5896,"_7":2225,"_2240":5897,"_11":5898,"_5777":-7,"_799":5899,"_452":5896},{"_5747":5893,"_7":2225,"_2240":5894,"_11":-7,"_5777":-7,"_799":5895,"_452":5893},{"_5747":5889,"_7":2225,"_2240":5890,"_11":5891,"_5777":-7,"_799":5892,"_452":5889},{"_5747":5885,"_7":2225,"_2240":5886,"_11":5887,"_5777":-7,"_799":5888,"_452":5885},{"_5747":5881,"_7":2225,"_2240":5882,"_11":5883,"_5777":-7,"_799":5884,"_452":5881},{"_5747":5877,"_7":2225,"_2240":5878,"_11":5879,"_5777":-7,"_799":5880,"_452":5877},{"_5747":5873,"_7":2225,"_2240":5874,"_11":5875,"_5777":-7,"_799":5876,"_452":5873},{"_5747":5869,"_7":2225,"_2240":5870,"_11":5871,"_5777":-7,"_799":5872,"_452":5869},{"_5747":5865,"_7":2225,"_2240":5866,"_11":5867,"_5777":-7,"_799":5868,"_452":5865},{"_5747":5861,"_7":2225,"_2240":5862,"_11":5863,"_5777":-7,"_799":5864,"_452":5861},{"_5747":5858,"_7":2225,"_2240":5859,"_11":-7,"_5777":-7,"_799":5860,"_452":5858},{"_5747":5854,"_7":2225,"_2240":5855,"_11":5856,"_5777":-7,"_799":5857,"_452":5854},"console/companies/activateConsoleCertificate.mdx","Ask SUNAT to prove this version POST POST","Answers 202 and nothing is switched yet. A DRAFT reaches ACTIVE only after this platform has signed a factura on the reserved series F000 with that certificate and SUNAT beta has accepted it (000052) — proof of control checked by the party that can check it. PRODUCTION is refused, because a production certificate cannot be proved against beta and issuing a real comprobante to prove it is not the platform's call. This route takes no Idempotency-Key: the key is derived from the version, so a double-click replays instead of probing twice.","/docs/console/companies/activateConsoleCertificate","console/companies/getConsoleCertificateActivation.mdx","How the activation probe went GET GET","/docs/console/companies/getConsoleCertificateActivation","console/companies/enrolConsoleCertificate.mdx","Enrol a new certificate version POST POST","ADMIN and above, which is the floor ADR 0016 point 7 sets for companies and the one 000060 already applies to minting a credential that carries certificates:manage. Takes the four secrets SUNAT needs: the PKCS#12, its password, and the SOL user and password that authenticate the submission. None of them touches a database connection — they cross the signing service binding and are sealed there. The result is a DRAFT that signs nothing; whatever certificate is signing today keeps signing until an activation probe is accepted by SUNAT.","/docs/console/companies/enrolConsoleCertificate","console/companies/listConsoleCertificates.mdx","The certificate versions this company has enrolled GET GET","ADMIN and above. Status and validity only: no storage location and no secret, because this route reads through the same repository the machine surface uses and that repository cannot read an envelope's location at all.","/docs/console/companies/listConsoleCertificates","console/companies/getConsoleActivity.mdx","The request and error log GET GET","The read that exists so a rejected comprobante does not become an email to support. One entry per SUNAT attempt -- retries are never collapsed -- plus operations that never reached SUNAT at all, each with the verbatim response code and description, the transport classification, and the PUBLIC prefix of the credential that started it. The free-form operations.result jsonb is deliberately NOT published: nothing bounds what a future workflow writes into it.","/docs/console/companies/getConsoleActivity","console/companies/getConsoleUsage.mdx","Plan consumption for this company GET GET","A read, and only a read. ADR 0016 point 6 keeps the quota holder on the company and usage.consume_quota is untouched. The period is this company's own plan period, not a window this route picked.","/docs/console/companies/getConsoleUsage","console/companies/revokeConsoleCredential.mdx","Revoke an API credential DELETE DELETE","Immediate, not at expiry: auth.lookup_api_credential re-reads revoked_at on every authenticated request, so the next one fails. Same DEVELOPER floor as minting, deliberately and never higher -- revocation is the emergency action, and a system where creating a credential is easier than killing it has the incentives backwards. Unknown, already revoked, and belonging to another company are one 404.","/docs/console/companies/revokeConsoleCredential","console/companies/mintConsoleCredential.mdx","Mint an API credential POST POST","DEVELOPER and above, which is what ADR 0016 point 7 assigns to that role. The credential can issue comprobantes, so this is the privilege escalation the ADR names and does not pretend otherwise about: the mitigation is that it is recorded. The credential row and its ops.audit_events row are written in one transaction by the SAME function the provisioning API calls, and a DEFERRABLE constraint trigger on auth.api_credentials refuses at COMMIT to admit a credential for an organization-owned company without one -- so an unaudited mint is not a policy violation, it is a failed transaction. THE TOKEN IS IN THE 201 AND NOWHERE ELSE. A scope the caller's own role could not exercise is refused with 403 SCOPE_NOT_GRANTABLE rather than silently dropped.","/docs/console/companies/mintConsoleCredential","console/companies/listConsoleCredentials.mdx","The API credentials of this company GET GET","Any member may read it, VIEWER included. It carries no secret -- there is no column holding one -- and the public prefix it does carry is already reported for every operation by GET /console/v1/companies/{companyId}/activity, so hiding this list would be a rule with no content. Revoked and expired credentials stay in it.","/docs/console/companies/listConsoleCredentials","console/companies/downloadConsoleArtifact.mdx","Stream one artifact GET GET","The bytes come from apps/artifact-worker, which re-verifies the SHA-256 and the byte size of what it reads before any of it reaches the caller. The object key never leaves the server. Use versions/{representationId} as the kind to fetch a specific PDF render.","/docs/console/companies/downloadConsoleArtifact","console/companies/listConsoleArtifacts.mdx","Everything the platform produced for one comprobante GET GET","/docs/console/companies/listConsoleArtifacts","console/companies/getConsoleDocument.mdx","One comprobante, with the SUNAT verdict and what it means GET GET","The response code and description are verbatim from the CDR. The severity/standing/action/guidance block is derived from the catalog in @apifact/sunat at read time and is not stored, so it cannot drift; catalogVersion, by contrast, reports the version recorded on the attempt, because claiming yesterday's rejection was judged by today's catalog would forge the audit trail.","/docs/console/companies/getConsoleDocument","console/companies/listConsoleDocuments.mdx","Comprobantes with their state GET GET","/docs/console/companies/listConsoleDocuments","console/companies/getConsoleCompany.mdx","Select a company to operate GET GET","The tenant binding of ADR 0016 point 5. auth.bind_console_company verifies the membership and sets app.tenant_id in ONE statement inside ONE transaction, and mints a binding token derived from a secret the console database role cannot read; every table the console can read carries a restrictive policy that demands it. Setting app.tenant_id by hand therefore widens nothing. A company in another organization and a company that does not exist both answer 404.","/docs/console/companies/getConsoleCompany","console/companies/listConsoleCompanies.mdx","The companies this session can operate GET GET","A listing, not an authorisation: it resolves membership across organizations and binds nothing. Selecting one is GET /console/v1/companies/{companyId}, which is where the membership check and the assignment of app.tenant_id happen as one act.","/docs/console/companies/listConsoleCompanies","Identity","Sign-up, verification, sessions and the second factor",[5917,5918,5919,5920,5921,5922,5923,5924,5925,5926,5927],"console/identity",{"_5770":5914,"_5778":5916},"console/identity/meta.json",{"_5747":5965,"_7":2225,"_2240":5966,"_11":5967,"_5777":-7,"_799":5968,"_452":5965},{"_5747":5961,"_7":2225,"_2240":5962,"_11":5963,"_5777":-7,"_799":5964,"_452":5961},{"_5747":5957,"_7":2225,"_2240":5958,"_11":5959,"_5777":-7,"_799":5960,"_452":5957},{"_5747":5953,"_7":2225,"_2240":5954,"_11":5955,"_5777":-7,"_799":5956,"_452":5953},{"_5747":5949,"_7":2225,"_2240":5950,"_11":5951,"_5777":-7,"_799":5952,"_452":5949},{"_5747":5945,"_7":2225,"_2240":5946,"_11":5947,"_5777":-7,"_799":5948,"_452":5945},{"_5747":5942,"_7":2225,"_2240":5943,"_11":-7,"_5777":-7,"_799":5944,"_452":5942},{"_5747":5938,"_7":2225,"_2240":5939,"_11":5940,"_5777":-7,"_799":5941,"_452":5938},{"_5747":5935,"_7":2225,"_2240":5936,"_11":-7,"_5777":-7,"_799":5937,"_452":5935},{"_5747":5931,"_7":2225,"_2240":5932,"_11":5933,"_5777":-7,"_799":5934,"_452":5931},{"_5747":5928,"_7":2225,"_2240":5929,"_11":-7,"_5777":-7,"_799":5930,"_452":5928},"console/identity/disableConsoleMfa.mdx","Remove the second factor DELETE DELETE","/docs/console/identity/disableConsoleMfa","console/identity/completeConsoleMfaEnrolment.mdx","Finish TOTP enrolment POST POST","The secret is sealed with AES-256-GCM under a versioned KEK, and the step the enrolling code used is recorded with it, so replaying that same code cannot also open a session.","/docs/console/identity/completeConsoleMfaEnrolment","console/identity/beginConsoleMfaEnrolment.mdx","Start TOTP enrolment POST POST","/docs/console/identity/beginConsoleMfaEnrolment","console/identity/changeConsolePassword.mdx","Change the password POST POST","Compare-and-swap against the hash just verified, so a change racing another loses instead of silently overwriting it. EVERY session dies, the caller's included: a password change cannot be distinguished from the response to a compromise, and the rule that is right in the second case is the one that applies to both.","/docs/console/identity/changeConsolePassword","console/identity/getConsoleSession.mdx","Who am I, and what do I belong to GET GET","/docs/console/identity/getConsoleSession","console/identity/closeConsoleSession.mdx","Log out DELETE DELETE","Revokes this session server-side and clears the cookie. The token is opaque and server-side precisely so this can be instantaneous rather than a matter of waiting for an expiry.","/docs/console/identity/closeConsoleSession","console/identity/closeAllConsoleSessions.mdx","Log out everywhere DELETE DELETE","Revokes every session of the caller, this one included. Needs a live session of its own, so it cannot be aimed at another user.","/docs/console/identity/closeAllConsoleSessions","console/identity/openConsoleSession.mdx","Log in POST POST","Sets the session cookie. When the account has TOTP enrolled and no totpCode was supplied -- or the code was replayed -- the answer is 401 MFA_REQUIRED and NO cookie; resend the same body with the code. There is no intermediate ticket, because a ticket is a second session-shaped secret with its own theft story. Every failure below a correct password is one indistinguishable 401 that costs one Argon2id verification, including for an address that was never registered.","/docs/console/identity/openConsoleSession","console/identity/verifyConsoleEmail.mdx","Spend an email verification token POST POST","Single use. Unknown, expired, already spent and belonging to a disabled account are one outcome and one status code: the consuming UPDATE is the check, so there is nothing to distinguish even if the handler wanted to.","/docs/console/identity/verifyConsoleEmail","console/identity/registerConsoleUser.mdx","Create an account and its first organization POST POST","Answers 202 with the same body whether or not the address was already registered, and pays the same Argon2id cost either way, so neither the response nor its duration is an oracle for who has an account. The registrant becomes the OWNER of a new organization -- the only way to become an OWNER other than being promoted by one. The organization starts with no companies; the registrant attaches one through POST /console/v1/organizations/{organizationId}/companies, which migration 000065 added. This sentence used to say the opposite -- that attaching was deliberately impossible -- and it is the fourth copy of that claim found after the route shipped, which is what a fact repeated in prose costs when nothing compares prose to paths.","/docs/console/identity/registerConsoleUser","console/identity/getConsoleOpenApi.mdx","This document GET GET","Anonymous, like the machine API's own /api/v2/openapi.json: a client that cannot yet log in still has to be able to read the contract for logging in. It carries no tenant data and no session data — it is the same bytes for every caller.","/docs/console/identity/getConsoleOpenApi","_1","separator","Consola (/console/v1)",[5976],"api/operations",{"_5770":5973,"_5778":5975},"api/operations/meta.json",{"_5747":5977,"_7":2225,"_2240":5978,"_11":2555,"_5777":-7,"_799":5979,"_452":5977},"api/operations/getOperation.mdx","Get a tenant-owned v2 operation GET GET","/docs/api/operations/getOperation",[5984,5985,5986],"api/consultations",{"_5770":5981,"_5778":5983},"api/consultations/meta.json",{"_5747":5993,"_7":2225,"_2240":5994,"_11":2749,"_5777":-7,"_799":5995,"_452":5993},{"_5747":5990,"_7":2225,"_2240":5991,"_11":2690,"_5777":-7,"_799":5992,"_452":5990},{"_5747":5987,"_7":2225,"_2240":5988,"_11":2622,"_5777":-7,"_799":5989,"_452":5987},"api/consultations/consultDni.mdx","Resolve a DNI to a person's NAME — informational, never a validation GET GET","/docs/api/consultations/consultDni","api/consultations/consultExchangeRate.mdx","Resolve the published exchange rate that applies on a given date GET GET","/docs/api/consultations/consultExchangeRate","api/consultations/consultTaxpayer.mdx","Look a RUC up in the hosted SUNAT padrón — informational, never a validation GET GET","/docs/api/consultations/consultTaxpayer",[6000,6001,6002,6003,6004,6005],"api/organizations",{"_5770":5997,"_5778":5999},"api/organizations/meta.json",{"_5747":6021,"_7":2225,"_2240":6022,"_11":3192,"_5777":-7,"_799":6023,"_452":6021},{"_5747":6018,"_7":2225,"_2240":6019,"_11":3114,"_5777":-7,"_799":6020,"_452":6018},{"_5747":6015,"_7":2225,"_2240":6016,"_11":3024,"_5777":-7,"_799":6017,"_452":6015},{"_5747":6012,"_7":2225,"_2240":6013,"_11":2937,"_5777":-7,"_799":6014,"_452":6012},{"_5747":6009,"_7":2225,"_2240":6010,"_11":2859,"_5777":-7,"_799":6011,"_452":6009},{"_5747":6006,"_7":2225,"_2240":6007,"_11":2800,"_5777":-7,"_799":6008,"_452":6006},"api/organizations/getOrganizationCompany.mdx","Read one client company, its capabilities, its certificate and its credentials GET GET","/docs/api/organizations/getOrganizationCompany","api/organizations/getOrganizationUsage.mdx","Consolidated consumption across every company in the organization GET GET","/docs/api/organizations/getOrganizationUsage","api/organizations/mintCompanyCredential.mdx","Mint an API credential for a client company POST POST","/docs/api/organizations/mintCompanyCredential","api/organizations/enrollOrganizationCompanyCertificate.mdx","Upload a client company's signing certificate and SOL credentials POST POST","/docs/api/organizations/enrollOrganizationCompanyCertificate","api/organizations/createOrganizationCompany.mdx","Register a client company under the calling organization POST POST","/docs/api/organizations/createOrganizationCompany","api/organizations/listOrganizationCompanies.mdx","List the client companies of the calling organization GET GET","/docs/api/organizations/listOrganizationCompanies",[6028,6029,6030,6031],"api/certificates",{"_5770":6025,"_5778":6027},"api/certificates/meta.json",{"_5747":6059,"_7":2225,"_2240":6060,"_11":3416,"_5777":-7,"_799":6061,"_452":6059},{"_5747":6053,"_7":2225,"_2240":6054,"_11":3481,"_5777":-7,"_799":6055,"_452":6053},{"_5747":6047,"_7":2225,"_2240":6048,"_11":3247,"_5777":-7,"_799":6049,"_452":6047},{"_5747":6032,"_7":2225,"_2240":6033,"_11":3320,"_5777":-7,"_799":6034,"_452":6032},"api/certificates/activateCertificate.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6040},"/docs/api/certificates/activateCertificate","$$typeof",["Y","react.transitional.element"],"span","key","ref",{"_6041":6042,"_6043":6044},"className","fd-page-tree-item-name","dangerouslySetInnerHTML",{"_6045":6046},"__html","Prove a DRAFT version against SUNAT and activate it only if SUNAT accepts POST POST","api/certificates/getCertificateActivation.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6050},"/docs/api/certificates/getCertificateActivation",{"_6041":6042,"_6043":6051},{"_6045":6052},"Read the verdict of this version's activation probe GET GET","api/certificates/enrollCertificate.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6056},"/docs/api/certificates/enrollCertificate",{"_6041":6042,"_6043":6057},{"_6045":6058},"Enrol a signing certificate and its SOL credentials as a DRAFT version POST POST","api/certificates/listCertificates.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6062},"/docs/api/certificates/listCertificates",{"_6041":6042,"_6043":6063},{"_6045":6064},"List this tenant's certificate versions with their state and validity GET GET",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6105},[6070,6071,6072,6073,6074],"api/webhooks",{"_5770":6067,"_5778":6069},"api/webhooks/meta.json",{"_5747":6099,"_7":2225,"_2240":6100,"_11":3779,"_5777":-7,"_799":6101,"_452":6099},{"_5747":6093,"_7":2225,"_2240":6094,"_11":3840,"_5777":-7,"_799":6095,"_452":6093},{"_5747":6087,"_7":2225,"_2240":6088,"_11":3704,"_5777":-7,"_799":6089,"_452":6087},{"_5747":6081,"_7":2225,"_2240":6082,"_11":3638,"_5777":-7,"_799":6083,"_452":6081},{"_5747":6075,"_7":2225,"_2240":6076,"_11":3560,"_5777":-7,"_799":6077,"_452":6075},"api/webhooks/rotateWebhookSecret.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6078},"/docs/api/webhooks/rotateWebhookSecret",{"_6041":6042,"_6043":6079},{"_6045":6080},"Mint the next signing secret version POST POST","api/webhooks/deleteWebhookSubscription.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6084},"/docs/api/webhooks/deleteWebhookSubscription",{"_6041":6042,"_6043":6085},{"_6045":6086},"Delete a subscription and everything still aimed at it DELETE DELETE","api/webhooks/updateWebhookSubscription.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6090},"/docs/api/webhooks/updateWebhookSubscription",{"_6041":6042,"_6043":6091},{"_6045":6092},"Change a subscription's destination, events or status PATCH PATCH","api/webhooks/createWebhookSubscription.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6096},"/docs/api/webhooks/createWebhookSubscription",{"_6041":6042,"_6043":6097},{"_6045":6098},"Register a signed webhook destination for this tenant POST POST","api/webhooks/listWebhookSubscriptions.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6102},"/docs/api/webhooks/listWebhookSubscriptions",{"_6041":6042,"_6043":6103},{"_6045":6104},"List this tenant's webhook subscriptions GET GET",{"_6041":6042,"_6043":6106},{"_6045":3630},{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6154},[6112,6113,6114,6115,6116,6117],"api/payment-regimes",{"_5770":6109,"_5778":6111},"api/payment-regimes/meta.json",{"_5747":6148,"_7":2225,"_2240":6149,"_11":4234,"_5777":-7,"_799":6150,"_452":6148},{"_5747":6142,"_7":2225,"_2240":6143,"_11":4191,"_5777":-7,"_799":6144,"_452":6142},{"_5747":6136,"_7":2225,"_2240":6137,"_11":4133,"_5777":-7,"_799":6138,"_452":6136},{"_5747":6130,"_7":2225,"_2240":6131,"_11":4030,"_5777":-7,"_799":6132,"_452":6130},{"_5747":6124,"_7":2225,"_2240":6125,"_11":3984,"_5777":-7,"_799":6126,"_452":6124},{"_5747":6118,"_7":2225,"_2240":6119,"_11":3919,"_5777":-7,"_799":6120,"_452":6118},"api/payment-regimes/submitPerception.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6121},"/docs/api/payment-regimes/submitPerception",{"_6041":6042,"_6043":6122},{"_6045":6123},"Durably request comprobante de percepción (CPE, 40) dispatch POST POST","api/payment-regimes/getPerception.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6127},"/docs/api/payment-regimes/getPerception",{"_6041":6042,"_6043":6128},{"_6045":6129},"Get a tenant-owned comprobante de percepción (CPE, 40) and its references GET GET","api/payment-regimes/createPerception.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6133},"/docs/api/payment-regimes/createPerception",{"_6041":6042,"_6043":6134},{"_6045":6135},"Validate and durably create a comprobante de percepción (CPE, 40) POST POST","api/payment-regimes/submitRetention.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6139},"/docs/api/payment-regimes/submitRetention",{"_6041":6042,"_6043":6140},{"_6045":6141},"Durably request comprobante de retención (CRE, 20) dispatch POST POST","api/payment-regimes/getRetention.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6145},"/docs/api/payment-regimes/getRetention",{"_6041":6042,"_6043":6146},{"_6045":6147},"Get a tenant-owned comprobante de retención (CRE, 20) and its references GET GET","api/payment-regimes/createRetention.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6151},"/docs/api/payment-regimes/createRetention",{"_6041":6042,"_6043":6152},{"_6045":6153},"Validate and durably create a comprobante de retención (CRE, 20) POST POST",{"_6041":6042,"_6043":6155},{"_6045":3979},{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6203},[6161,6162,6163,6164,6165,6166],"api/summaries",{"_5770":6158,"_5778":6160},"api/summaries/meta.json",{"_5747":6197,"_7":2225,"_2240":6198,"_11":4611,"_5777":-7,"_799":6199,"_452":6197},{"_5747":6191,"_7":2225,"_2240":6192,"_11":4382,"_5777":-7,"_799":6193,"_452":6191},{"_5747":6185,"_7":2225,"_2240":6186,"_11":4511,"_5777":-7,"_799":6187,"_452":6185},{"_5747":6179,"_7":2225,"_2240":6180,"_11":4427,"_5777":-7,"_799":6181,"_452":6179},{"_5747":6173,"_7":2225,"_2240":6174,"_11":4382,"_5777":-7,"_799":6175,"_452":6173},{"_5747":6167,"_7":2225,"_2240":6168,"_11":4322,"_5777":-7,"_799":6169,"_452":6167},"api/summaries/requestVoidedCommunicationSubmission.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6170},"/docs/api/summaries/requestVoidedCommunicationSubmission",{"_6041":6042,"_6043":6171},{"_6045":6172},"Durably request void communication (RA) dispatch POST POST","api/summaries/getVoidedCommunication.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6176},"/docs/api/summaries/getVoidedCommunication",{"_6041":6042,"_6043":6177},{"_6045":6178},"Get a tenant-owned void communication (RA) and its ticket operation GET GET","api/summaries/createVoidedCommunication.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6182},"/docs/api/summaries/createVoidedCommunication",{"_6041":6042,"_6043":6183},{"_6045":6184},"Validate and durably create a void communication (RA) POST POST","api/summaries/requestSummarySubmission.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6188},"/docs/api/summaries/requestSummarySubmission",{"_6041":6042,"_6043":6189},{"_6045":6190},"Durably request daily summary (RC) dispatch POST POST","api/summaries/getSummary.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6194},"/docs/api/summaries/getSummary",{"_6041":6042,"_6043":6195},{"_6045":6196},"Get a tenant-owned daily summary (RC) and its ticket operation GET GET","api/summaries/createSummary.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6200},"/docs/api/summaries/createSummary",{"_6041":6042,"_6043":6201},{"_6045":6202},"Validate and durably create a daily summary (RC) POST POST",{"_6041":6042,"_6043":6204},{"_6045":4377},{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6238},[6210,6211,6212,6213],"api/artifacts",{"_5770":6207,"_5778":6209},"api/artifacts/meta.json",{"_5747":6232,"_7":2225,"_2240":6233,"_11":4905,"_5777":-7,"_799":6234,"_452":6232},{"_5747":6226,"_7":2225,"_2240":6227,"_11":4846,"_5777":-7,"_799":6228,"_452":6226},{"_5747":6220,"_7":2225,"_2240":6221,"_11":4767,"_5777":-7,"_799":6222,"_452":6220},{"_5747":6214,"_7":2225,"_2240":6215,"_11":-7,"_5777":-7,"_799":6216,"_452":6214},"api/artifacts/downloadPdfRepresentation.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6217},"/docs/api/artifacts/downloadPdfRepresentation",{"_6041":6042,"_6043":6218},{"_6045":6219},"Download an immutable versioned PDF representation GET GET","api/artifacts/downloadDocumentArtifact.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6223},"/docs/api/artifacts/downloadDocumentArtifact",{"_6041":6042,"_6043":6224},{"_6045":6225},"Stream and integrity-check a public document artifact GET GET","api/artifacts/listDocumentArtifacts.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6229},"/docs/api/artifacts/listDocumentArtifacts",{"_6041":6042,"_6043":6230},{"_6045":6231},"List public artifacts for a tenant-owned document GET GET","api/artifacts/requestPdfGeneration.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6235},"/docs/api/artifacts/requestPdfGeneration",{"_6041":6042,"_6043":6236},{"_6045":6237},"Durably request immutable PDF representations POST POST",{"_6041":6042,"_6043":6239},{"_6045":4762},{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6273},[6245,6246,6247,6248],"api/documents",{"_5770":6242,"_5778":6244},"api/documents/meta.json",{"_5747":6267,"_7":2225,"_2240":6268,"_11":5162,"_5777":-7,"_799":6269,"_452":6267},{"_5747":6261,"_7":2225,"_2240":6262,"_11":5087,"_5777":-7,"_799":6263,"_452":6261},{"_5747":6255,"_7":2225,"_2240":6256,"_11":-7,"_5777":-7,"_799":6257,"_452":6255},{"_5747":6249,"_7":2225,"_2240":6250,"_11":4985,"_5777":-7,"_799":6251,"_452":6249},"api/documents/requestDocumentSubmission.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6252},"/docs/api/documents/requestDocumentSubmission",{"_6041":6042,"_6043":6253},{"_6045":6254},"Durably request document submission POST POST","api/documents/getDocument.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6258},"/docs/api/documents/getDocument",{"_6041":6042,"_6043":6259},{"_6045":6260},"Get a tenant-owned document and its canonical state GET GET","api/documents/validateDocument.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6264},"/docs/api/documents/validateDocument",{"_6041":6042,"_6043":6265},{"_6045":6266},"Ask what POST /api/v2/documents would answer, without creating anything POST POST","api/documents/createDocument.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6270},"/docs/api/documents/createDocument",{"_6041":6042,"_6043":6271},{"_6045":6272},"Validate and durably create a canonical invoice, receipt or fiscal note POST POST",{"_6041":6042,"_6043":6274},{"_6045":5038},{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6308},[6280,6281,6282,6283],"api/legacy-compatibility",{"_5770":6277,"_5778":6279},"api/legacy-compatibility/meta.json",{"_5747":6302,"_7":2225,"_2240":6303,"_11":5621,"_5777":-7,"_799":6304,"_452":6302},{"_5747":6296,"_7":2225,"_2240":6297,"_11":5549,"_5777":-7,"_799":6298,"_452":6296},{"_5747":6290,"_7":2225,"_2240":6291,"_11":5397,"_5777":-7,"_799":6292,"_452":6290},{"_5747":6284,"_7":2225,"_2240":6285,"_11":5397,"_5777":-7,"_799":6286,"_452":6284},"api/legacy-compatibility/generateLegacyInvoiceTicket.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6287},"/docs/api/legacy-compatibility/generateLegacyInvoiceTicket",{"_6041":6042,"_6043":6288},{"_6045":6289},"Durably request an immutable ticket representation POST POST","api/legacy-compatibility/generateLegacyInvoiceA4.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6293},"/docs/api/legacy-compatibility/generateLegacyInvoiceA4",{"_6041":6042,"_6043":6294},{"_6045":6295},"Durably request an immutable A4 representation POST POST","api/legacy-compatibility/submitLegacyInvoice.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6299},"/docs/api/legacy-compatibility/submitLegacyInvoice",{"_6041":6042,"_6043":6300},{"_6045":6301},"Durably request SUNAT submission for a legacy document identity POST POST","api/legacy-compatibility/createLegacyInvoice.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6305},"/docs/api/legacy-compatibility/createLegacyInvoice",{"_6041":6042,"_6043":6306},{"_6045":6307},"Validate and store a legacy factura or boleta payload POST POST",{"_6041":6042,"_6043":6309},{"_6045":5473},{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6329},[6315,6316],"api/system",{"_5770":6312,"_5778":6314},"api/system/meta.json",{"_5747":6323,"_7":2225,"_2240":6324,"_11":-7,"_5777":-7,"_799":6325,"_452":6323},{"_5747":6317,"_7":2225,"_2240":6318,"_11":-7,"_5777":-7,"_799":6319,"_452":6317},"api/system/getOpenApiV2.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6320},"/docs/api/system/getOpenApiV2",{"_6041":6042,"_6043":6321},{"_6045":6322},"Get Open Api V2 GET GET","api/system/getHealth.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6326},"/docs/api/system/getHealth",{"_6041":6042,"_6043":6327},{"_6045":6328},"Get Health GET GET",{"_6041":6042,"_6043":6330},{"_6045":31},"_0",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6333},{"_6041":6042,"_6043":6334},{"_6045":6335},"API para máquinas (/api/v2)","quickstart.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6340},"De cero al CDR de SUNAT en beta, sin emitir nada por accidente.","/docs/quickstart",{"_6041":6042,"_6043":6341},{"_6045":6342},"Quickstart","entornos.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6347},"BETA y PRODUCTION, y qué cambia realmente al pasar de uno al otro.","/docs/entornos",{"_6041":6042,"_6043":6348},{"_6045":6349},"Entornos","index.mdx",{"_6035":6036,"_7":6037,"_6038":-5,"_6039":-5,"_14":6354},"La API de facturación electrónica de Fac-360 para el Perú.","/docs",{"_6041":6042,"_6043":6355},{"_6045":6356},"Introducción","","meta.json"]

Get Open Api V2

Response Body

200