[{"data":1,"prerenderedAt":364},["ShallowReactive",2],{"navigation_docs":3,"-guias-conceptos-referencia-u-objeto":102,"-guias-conceptos-referencia-u-objeto-surround":359},[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":352,"extension":353,"links":354,"meta":355,"navigation":356,"path":34,"seo":357,"stem":35,"__hash__":358},"docs\u002F1.guias\u002F2.conceptos\u002F2.referencia-u-objeto.md","Referencia u objeto: qué hace cada forma",{"type":106,"value":107,"toc":348},"minimark",[108,112,169,172,177,180,284,289,311,315,336,344],[109,110,111],"p",{},"Donde una venta o una compra pide un registro del catálogo (el cliente o el proveedor, la condición de\npago, el vendedor y su zona, el servicio o el producto de cada línea), el mismo campo acepta dos\nformas:",[113,114,115,131],"table",{},[116,117,118],"thead",{},[119,120,121,125,128],"tr",{},[122,123,124],"th",{},"Forma",[122,126,127],{},"Qué envías",[122,129,130],{},"Qué hace con el registro",[132,133,134,152],"tbody",{},[119,135,136,143,146],{},[137,138,139],"td",{},[140,141,142],"strong",{},"Referencia",[137,144,145],{},"El id de Openbox Cloud del registro, como texto",[137,147,148,149],{},"Lo usa tal cual; ",[140,150,151],{},"nunca lo modifica",[119,153,154,159,162],{},[137,155,156],{},[140,157,158],{},"Objeto",[137,160,161],{},"El registro completo",[137,163,164,165,168],{},"Lo crea o lo ",[140,166,167],{},"reescribe"," con lo que envías",[109,170,171],{},"Puedes mezclar: una referencia en un campo y un objeto en otro, dentro de la misma venta.",[173,174,176],"insignia-operacion",{"id":175},"partnersV1InvoicesCreateSingle","Disponible",[173,178,176],{"id":179},"partnersV1PurchasesCreateSingle",[181,182,188],"pre",{"className":183,"code":184,"filename":185,"language":186,"meta":187,"style":187},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"customer\": \"0a1b2c3d-1111-9999-0000-123456789abc\",\n  \"paymentCondition\": { \"name\": \"Contado\", \"cashPayment\": true }\n}\n","fragmento","json","",[189,190,191,200,228,278],"code",{"__ignoreMap":187},[192,193,196],"span",{"class":194,"line":195},"line",1,[192,197,199],{"class":198},"sMK4o","{\n",[192,201,203,206,210,213,216,219,223,225],{"class":194,"line":202},2,[192,204,205],{"class":198},"  \"",[192,207,209],{"class":208},"spNyl","customer",[192,211,212],{"class":198},"\"",[192,214,215],{"class":198},":",[192,217,218],{"class":198}," \"",[192,220,222],{"class":221},"sfazB","0a1b2c3d-1111-9999-0000-123456789abc",[192,224,212],{"class":198},[192,226,227],{"class":198},",\n",[192,229,231,233,236,238,240,243,245,249,251,253,255,258,260,263,265,268,270,272,275],{"class":194,"line":230},3,[192,232,205],{"class":198},[192,234,235],{"class":208},"paymentCondition",[192,237,212],{"class":198},[192,239,215],{"class":198},[192,241,242],{"class":198}," {",[192,244,218],{"class":198},[192,246,248],{"class":247},"sBMFI","name",[192,250,212],{"class":198},[192,252,215],{"class":198},[192,254,218],{"class":198},[192,256,257],{"class":221},"Contado",[192,259,212],{"class":198},[192,261,262],{"class":198},",",[192,264,218],{"class":198},[192,266,267],{"class":247},"cashPayment",[192,269,212],{"class":198},[192,271,215],{"class":198},[192,273,274],{"class":198}," true",[192,276,277],{"class":198}," }\n",[192,279,281],{"class":194,"line":280},4,[192,282,283],{"class":198},"}\n",[285,286,288],"h2",{"id":287},"la-referencia-por-forma","La referencia, por forma",[109,290,291,292,294,295,298,299,302,303,306,307,310],{},"Una referencia se valida por forma: 8-4-4-4-12 caracteres hexadecimales\n(",[189,293,222],{},"), sin exigir la versión RFC. El OpenAPI publicado lo describe\ncon un ",[189,296,297],{},"pattern",", no con ",[189,300,301],{},"format: uuid",", para que tu validador o tu cliente generado lo acepte. Una\nreferencia que no existe en tu empresa, o que fue eliminada, responde ",[189,304,305],{},"400"," con el código\n",[189,308,309],{},"REFERENCE_NOT_FOUND"," y no se escribe nada.",[285,312,314],{"id":313},"cuál-conviene","Cuál conviene",[316,317,318,328],"ul",{},[319,320,321,323,324,327],"li",{},[140,322,142],{}," cuando el registro ya está en el catálogo: la venta no reescribe los datos fiscales\ndel cliente y el payload es más pequeño. Es la forma de\n",[325,326,58],"a",{"href":59},".",[319,329,330,332,333,327],{},[140,331,158],{}," cuando tu sistema no guarda el id de Openbox Cloud: cada venta lleva el registro\ncompleto, como en ",[325,334,335],{"href":63},"Vender con payload completo",[109,337,338,339,341,342,327],{},"Para pasar de una a otra sin cortar la facturación, ver\n",[325,340,78],{"href":79},". Qué campo lleva cada pieza está en el\n",[325,343,37],{"href":38},[345,346,347],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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);}",{"title":187,"searchDepth":202,"depth":202,"links":349},[350,351],{"id":287,"depth":202,"text":288},{"id":313,"depth":202,"text":314},"Cada registro del catálogo que lleva una venta o una compra va como referencia o como objeto, en el mismo campo.","md",null,{},{"title":33},{"title":104,"description":352},"YCSM0l9gszYDFtyS9HACnyf3KYeuIXkahaSNdYESvvA",[360,362],{"title":29,"path":30,"stem":31,"description":361,"children":-1},"Tu identificador en cada registro del catálogo, el id de Openbox Cloud y cómo pasar de uno a otro.",{"title":37,"path":38,"stem":39,"description":363,"children":-1},"Qué registro del catálogo usa la venta y la compra, y en qué campo de su cuerpo va cada uno.",1795295097551]