[{"data":1,"prerenderedAt":661},["ShallowReactive",2],{"navigation_docs":3,"-guias-recetas-compra-a-sujeto-excluido":102,"-guias-recetas-compra-a-sujeto-excluido-surround":656},[4],{"title":5,"path":6,"stem":7,"children":8,"page":22},"Guías","\u002Fguias","1.guias",[9,23,48,81],{"title":10,"path":11,"stem":12,"children":13,"page":22},"Empezar","\u002Fguias\u002Fempezar","1.guias\u002F1.empezar",[14,18],{"title":15,"path":16,"stem":17},"Ambientes","\u002Fguias\u002Fempezar\u002Fambientes","1.guias\u002F1.empezar\u002F1.ambientes",{"title":19,"path":20,"stem":21},"Autenticación","\u002Fguias\u002Fempezar\u002Fautenticacion","1.guias\u002F1.empezar\u002F2.autenticacion",false,{"title":24,"path":25,"stem":26,"children":27,"page":22},"Conceptos","\u002Fguias\u002Fconceptos","1.guias\u002F2.conceptos",[28,32,36,40,44],{"title":29,"path":30,"stem":31},"Tu internalId y los ids","\u002Fguias\u002Fconceptos\u002Finternal-id","1.guias\u002F2.conceptos\u002F1.internal-id",{"title":33,"path":34,"stem":35},"Referencia u objeto","\u002Fguias\u002Fconceptos\u002Freferencia-u-objeto","1.guias\u002F2.conceptos\u002F2.referencia-u-objeto",{"title":37,"path":38,"stem":39},"Mapa del catálogo","\u002Fguias\u002Fconceptos\u002Fmapa-del-catalogo","1.guias\u002F2.conceptos\u002F3.mapa-del-catalogo",{"title":41,"path":42,"stem":43},"Permisos por módulo","\u002Fguias\u002Fconceptos\u002Fpermisos","1.guias\u002F2.conceptos\u002F4.permisos",{"title":45,"path":46,"stem":47},"Disponibilidad","\u002Fguias\u002Fconceptos\u002Fdisponibilidad","1.guias\u002F2.conceptos\u002F5.disponibilidad",{"title":49,"path":50,"stem":51,"children":52,"page":22},"Recetas","\u002Fguias\u002Frecetas","1.guias\u002F3.recetas",[53,57,61,65,69,73,77],{"title":54,"path":55,"stem":56},"Sincronizar el catálogo","\u002Fguias\u002Frecetas\u002Fsincronizar-catalogo","1.guias\u002F3.recetas\u002F1.sincronizar-catalogo",{"title":58,"path":59,"stem":60},"Vender por referencias","\u002Fguias\u002Frecetas\u002Fvender-por-referencias","1.guias\u002F3.recetas\u002F2.vender-por-referencias",{"title":62,"path":63,"stem":64},"Vender con payload","\u002Fguias\u002Frecetas\u002Fvender-con-payload-completo","1.guias\u002F3.recetas\u002F3.vender-con-payload-completo",{"title":66,"path":67,"stem":68},"Compra sujeto excluido","\u002Fguias\u002Frecetas\u002Fcompra-a-sujeto-excluido","1.guias\u002F3.recetas\u002F4.compra-a-sujeto-excluido",{"title":70,"path":71,"stem":72},"Consultar y conciliar","\u002Fguias\u002Frecetas\u002Fconsultar-y-conciliar","1.guias\u002F3.recetas\u002F5.consultar-y-conciliar",{"title":74,"path":75,"stem":76},"Anular una venta","\u002Fguias\u002Frecetas\u002Fanular-venta","1.guias\u002F3.recetas\u002F6.anular-venta",{"title":78,"path":79,"stem":80},"Migrar a referencias","\u002Fguias\u002Frecetas\u002Fmigrar-a-referencias","1.guias\u002F3.recetas\u002F7.migrar-a-referencias",{"title":82,"path":83,"stem":84,"children":85,"page":22},"Operar","\u002Fguias\u002Foperar","1.guias\u002F4.operar",[86,90,94,98],{"title":87,"path":88,"stem":89},"Errores","\u002Fguias\u002Foperar\u002Ferrores","1.guias\u002F4.operar\u002F1.errores",{"title":91,"path":92,"stem":93},"Reintentos","\u002Fguias\u002Foperar\u002Freintentos","1.guias\u002F4.operar\u002F2.reintentos",{"title":95,"path":96,"stem":97},"Contingencia","\u002Fguias\u002Foperar\u002Fcontingencia","1.guias\u002F4.operar\u002F3.contingencia",{"title":99,"path":100,"stem":101},"Cambios del contrato","\u002Fguias\u002Foperar\u002Fcambios-del-contrato","1.guias\u002F4.operar\u002F4.cambios-del-contrato",{"id":103,"title":104,"body":105,"description":649,"extension":650,"links":651,"meta":652,"navigation":653,"path":67,"seo":654,"stem":68,"__hash__":655},"docs\u002F1.guias\u002F3.recetas\u002F4.compra-a-sujeto-excluido.md","Registrar una compra a sujeto excluido",{"type":106,"value":107,"toc":642},"minimark",[108,113,127,132,166,170,188,199,203,234,238,321,334,531,551,567,571,633,638],[109,110,112],"insignia-operacion",{"id":111},"partnersV1PurchasesCreateSingle","Disponible",[114,115,116,117,121,122,126],"p",{},"Al terminar tendrás una ",[118,119,120],"strong",{},"factura de sujeto excluido"," (",[123,124,125],"code",{},"documentType: FSE",") enviada al MH, con\nsu estado y los enlaces a su PDF y su JSON. El proveedor y la condición de pago se citan por su\nUUID de Openbox Cloud, así cada compra no reescribe tu catálogo.",[128,129,131],"h2",{"id":130},"antes-de-empezar","Antes de empezar",[133,134,135,143,159],"ul",{},[136,137,138,139,142],"li",{},"Una sesión iniciada con tu llave (",[140,141,19],"a",{"href":20},").",[136,144,145,146,149,150,152,153,156,157,142],{},"La llave necesita el módulo ",[118,147,148],{},"Compras"," en su perfil (",[140,151,41],{"href":42},").\nSin él, crear la compra responde ",[123,154,155],{},"403"," sin escribir nada (ver ",[140,158,87],{"href":88},[136,160,161,162,165],{},"Para el paso 1, la llave necesita también el módulo ",[118,163,164],{},"Proveedores",".",[128,167,169],{"id":168},"paso-1-ten-al-proveedor-en-el-catálogo","Paso 1 · Ten al proveedor en el catálogo",[114,171,172,173,176,177,180,181,184,185,165],{},"Crea el proveedor una sola vez con ",[109,174,112],{"id":175},"partnersV1ProvidersCreateSingle"," y\nguarda el ",[123,178,179],{},"id"," de la respuesta: es el UUID que citarás en cada compra. Si solo lo conoces por tu\n",[123,182,183],{},"internalId",", recupéralo con ",[109,186,112],{"id":187},"partnersV1ProvidersGetMany",[189,190,191,192,195,196,165],"warning",{},"La compra usa los datos ",[118,193,194],{},"guardados"," del proveedor tal cual: su documento, su nombre y la dirección\nde su sucursal principal son los que recibe el MH. Si falta o cambió alguno, corrígelo antes de\ncomprar con ",[109,197,112],{"id":198},"partnersV1ProvidersUpdateSingle",[128,200,202],{"id":201},"paso-2-elige-la-condición-de-pago","Paso 2 · Elige la condición de pago",[114,204,205,206,209,210,213,214,216,217,220,221,224,225,227,228,230,231,233],{},"Necesitas una ",[118,207,208],{},"condición de pago de compra"," de tu empresa (por ejemplo, contado). Las condiciones\nde pago de compra se listan con\n",[109,211,112],{"id":212},"partnersV1PurchasesPaymentConditionsGetMany",". Si no tienes su UUID,\nenvía la primera compra con la condición como objeto (",[123,215,179],{},", ",[123,218,219],{},"name"," y ",[123,222,223],{},"cashPayment","), con un UUID\nnuevo que generes tú en ",[123,226,179],{},": Openbox Cloud la crea con ese ",[123,229,179],{},". Sigue enviándola como objeto\nhasta que una compra responda con éxito; desde entonces, las compras siguientes la citan por ese\n",[123,232,179],{},". Una condición de pago de venta no sirve aquí: son catálogos distintos.",[128,235,237],{"id":236},"paso-3-crea-la-compra","Paso 3 · Crea la compra",[239,240,246],"pre",{"className":241,"code":242,"filename":243,"language":244,"meta":245,"style":245},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X POST \"$OPENBOX_API_URL\u002Fpartners\u002Fv1\u002Fpurchases\" \\\n  -H 'Authorization: Bearer \u003CTOKEN>' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d @compra.json\n","Terminal","bash","",[123,247,248,281,298,312],{"__ignoreMap":245},[249,250,253,257,261,264,268,272,275,278],"span",{"class":251,"line":252},"line",1,[249,254,256],{"class":255},"sBMFI","curl",[249,258,260],{"class":259},"sfazB"," -X",[249,262,263],{"class":259}," POST",[249,265,267],{"class":266},"sMK4o"," \"",[249,269,271],{"class":270},"sTEyZ","$OPENBOX_API_URL",[249,273,274],{"class":259},"\u002Fpartners\u002Fv1\u002Fpurchases",[249,276,277],{"class":266},"\"",[249,279,280],{"class":270}," \\\n",[249,282,284,287,290,293,296],{"class":251,"line":283},2,[249,285,286],{"class":259},"  -H",[249,288,289],{"class":266}," '",[249,291,292],{"class":259},"Authorization: Bearer \u003CTOKEN>",[249,294,295],{"class":266},"'",[249,297,280],{"class":270},[249,299,301,303,305,308,310],{"class":251,"line":300},3,[249,302,286],{"class":259},[249,304,289],{"class":266},[249,306,307],{"class":259},"Content-Type: application\u002Fjson",[249,309,295],{"class":266},[249,311,280],{"class":270},[249,313,315,318],{"class":251,"line":314},4,[249,316,317],{"class":259},"  -d",[249,319,320],{"class":259}," @compra.json\n",[114,322,323,324,216,327,220,330,333],{},"En ",[123,325,326],{},"compra.json",[123,328,329],{},"provider",[123,331,332],{},"paymentCondition"," llevan el UUID como texto:",[239,335,340],{"className":336,"code":337,"filename":338,"language":339,"meta":245,"style":245},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"settings\": { \"notify\": \"EMAIL\", \"internalId\": \"CMP-0001\" },\n  \"data\": {\n    \"header\": {\n      \"documentType\": \"FSE\",\n      \"purchaseDate\": \"2026-10-30\",\n      \"provider\": \"0a1b2c3d-1111-9999-0000-123456789abc\",\n      \"paymentCondition\": \"5e6f7a8b-2222-9999-0000-123456789abc\"\n    }\n  }\n}\n","compra.json (fragmento)","json",[123,341,342,347,401,415,429,453,474,494,513,519,525],{"__ignoreMap":245},[249,343,344],{"class":251,"line":252},[249,345,346],{"class":266},"{\n",[249,348,349,352,356,358,361,364,366,369,371,373,375,378,380,383,385,387,389,391,393,396,398],{"class":251,"line":283},[249,350,351],{"class":266},"  \"",[249,353,355],{"class":354},"spNyl","settings",[249,357,277],{"class":266},[249,359,360],{"class":266},":",[249,362,363],{"class":266}," {",[249,365,267],{"class":266},[249,367,368],{"class":255},"notify",[249,370,277],{"class":266},[249,372,360],{"class":266},[249,374,267],{"class":266},[249,376,377],{"class":259},"EMAIL",[249,379,277],{"class":266},[249,381,382],{"class":266},",",[249,384,267],{"class":266},[249,386,183],{"class":255},[249,388,277],{"class":266},[249,390,360],{"class":266},[249,392,267],{"class":266},[249,394,395],{"class":259},"CMP-0001",[249,397,277],{"class":266},[249,399,400],{"class":266}," },\n",[249,402,403,405,408,410,412],{"class":251,"line":300},[249,404,351],{"class":266},[249,406,407],{"class":354},"data",[249,409,277],{"class":266},[249,411,360],{"class":266},[249,413,414],{"class":266}," {\n",[249,416,417,420,423,425,427],{"class":251,"line":314},[249,418,419],{"class":266},"    \"",[249,421,422],{"class":255},"header",[249,424,277],{"class":266},[249,426,360],{"class":266},[249,428,414],{"class":266},[249,430,432,435,439,441,443,445,448,450],{"class":251,"line":431},5,[249,433,434],{"class":266},"      \"",[249,436,438],{"class":437},"sbssI","documentType",[249,440,277],{"class":266},[249,442,360],{"class":266},[249,444,267],{"class":266},[249,446,447],{"class":259},"FSE",[249,449,277],{"class":266},[249,451,452],{"class":266},",\n",[249,454,456,458,461,463,465,467,470,472],{"class":251,"line":455},6,[249,457,434],{"class":266},[249,459,460],{"class":437},"purchaseDate",[249,462,277],{"class":266},[249,464,360],{"class":266},[249,466,267],{"class":266},[249,468,469],{"class":259},"2026-10-30",[249,471,277],{"class":266},[249,473,452],{"class":266},[249,475,477,479,481,483,485,487,490,492],{"class":251,"line":476},7,[249,478,434],{"class":266},[249,480,329],{"class":437},[249,482,277],{"class":266},[249,484,360],{"class":266},[249,486,267],{"class":266},[249,488,489],{"class":259},"0a1b2c3d-1111-9999-0000-123456789abc",[249,491,277],{"class":266},[249,493,452],{"class":266},[249,495,497,499,501,503,505,507,510],{"class":251,"line":496},8,[249,498,434],{"class":266},[249,500,332],{"class":437},[249,502,277],{"class":266},[249,504,360],{"class":266},[249,506,267],{"class":266},[249,508,509],{"class":259},"5e6f7a8b-2222-9999-0000-123456789abc",[249,511,512],{"class":266},"\"\n",[249,514,516],{"class":251,"line":515},9,[249,517,518],{"class":266},"    }\n",[249,520,522],{"class":251,"line":521},10,[249,523,524],{"class":266},"  }\n",[249,526,528],{"class":251,"line":527},11,[249,529,530],{"class":266},"}\n",[114,532,533,535,536,539,540,543,544,548,549,142],{},[123,534,460],{}," es la fecha de emisión del documento que recibe el MH. Las líneas (",[123,537,538],{},"details",") y los\ntotales (",[123,541,542],{},"totals",") completan el cuerpo; su esquema está en la\n",[140,545,547],{"href":546},"\u002Freferencia","Referencia",". En el mismo campo puedes enviar el objeto completo del proveedor o de la\ncondición de pago: Openbox Cloud lo crea o lo actualiza con lo que envías\n(",[140,550,33],{"href":34},[114,552,553,554,220,557,560,561,564,565,165],{},"La respuesta trae ",[123,555,556],{},"status",[123,558,559],{},"haciendaResponse",", la respuesta del MH. Revisa ambos antes de dar la\ncompra por presentada: una compra en ",[123,562,563],{},"CONTINGENCIA"," no tiene el sello del MH. Para volver a\nconsultarla, ve a ",[140,566,70],{"href":71},[128,568,570],{"id":569},"si-algo-falla","Si algo falla",[133,572,573,590,601,613,618],{},[136,574,575,578,579,582,583,586,587,589],{},[123,576,577],{},"400"," con ",[123,580,581],{},"code: REFERENCE_NOT_FOUND",": el proveedor o la condición de pago que citas no existe en\ntu empresa o fue eliminado; ",[123,584,585],{},"message"," dice cuál. También lo recibes si envías como objeto un\nproveedor o una condición de pago cuyo ",[123,588,179],{}," es de un registro que tu empresa eliminó. No se escribe\nnada.",[136,591,592,594,595,597,598,600],{},[123,593,577],{}," sin ",[123,596,123],{},", con ",[123,599,585],{}," como lista: la petición no cumple el contrato; cada elemento\nnombra un campo. No se escribe nada.",[136,602,603,594,605,597,607,609,610,612],{},[123,604,577],{},[123,606,123],{},[123,608,585],{}," como texto: ",[123,611,585],{}," dice el motivo, por ejemplo una dirección\ndel proveedor que no existe en el catálogo. Si el motivo es la validación electrónica del documento\no la configuración de facturación electrónica de tu empresa, el proveedor o la condición de pago\nque enviaste como objeto pueden haber quedado creados o actualizados.",[136,614,615,617],{},[123,616,155],{},": la llave no tiene el módulo Compras.",[136,619,620,623,624,626,627,629,630,142],{},[123,621,622],{},"409",": ya existe una compra con ese ",[123,625,183],{}," en un estado que impide recrearla, o el ",[123,628,179],{}," de un\nobjeto que enviaste ya existe fuera de tu empresa (",[123,631,632],{},"code: INTERNAL_ID_DUPLICATED",[114,634,635,636,165],{},"El detalle de cada código está en ",[140,637,87],{"href":88},[639,640,641],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":245,"searchDepth":283,"depth":283,"links":643},[644,645,646,647,648],{"id":130,"depth":283,"text":131},{"id":168,"depth":283,"text":169},{"id":201,"depth":283,"text":202},{"id":236,"depth":283,"text":237},{"id":569,"depth":283,"text":570},"Receta de principio a fin: proveedor, condición de pago y la factura de sujeto excluido.","md",null,{},{"title":66},{"title":104,"description":649},"64JJ_JDwmq5XAaog-7Cb81Hge-qDiFEjO2g4b99mcaQ",[657,659],{"title":62,"path":63,"stem":64,"description":658,"children":-1},"La venta lleva el cliente, las líneas y los totales completos, cada registro como objeto.",{"title":70,"path":71,"stem":72,"description":660,"children":-1},"Consulta ventas y compras por el id de Openbox Cloud o por tu internalId, y concilia su estado con tu sistema.",1795293794014]