[{"data":1,"prerenderedAt":696},["ShallowReactive",2],{"navigation_docs":3,"-guias-recetas-vender-por-referencias":102,"-guias-recetas-vender-por-referencias-surround":691},[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":684,"extension":685,"links":686,"meta":687,"navigation":688,"path":59,"seo":689,"stem":60,"__hash__":690},"docs\u002F1.guias\u002F3.recetas\u002F2.vender-por-referencias.md","Vender por referencias (recomendada)",{"type":106,"value":107,"toc":675},"minimark",[108,113,150,155,171,175,185,469,539,546,550,557,562,591,595,602,606,613,659,671],[109,110,112],"insignia-operacion",{"id":111},"partnersV1InvoicesCreateSingle","Disponible",[114,115,116,128],"tip",{},[117,118,119,123,124,127],"p",{},[120,121,122],"strong",{},"Esta es la forma recomendada."," Registras una sola vez el cliente, los servicios o productos, la\ncondición de pago, el vendedor y la zona en el catálogo, y cada venta los ",[120,125,126],{},"cita"," por su id de\nOpenbox Cloud en lugar de enviarlos completos.",[129,130,131,138,144],"ul",{},[132,133,134,137],"li",{},[120,135,136],{},"No sobrescribe los datos fiscales del cliente",": una referencia nunca modifica el registro;\ncon un objeto, cada venta lo reescribe con lo que envías.",[132,139,140,143],{},[120,141,142],{},"Payloads más pequeños",": la venta lleva un texto de 36 caracteres por registro, no el objeto\nentero.",[132,145,146,149],{},[120,147,148],{},"Reutilización",": el mismo registro sirve a todas las ventas, y lo corriges en un solo lugar.",[151,152,154],"h2",{"id":153},"paso-1-ten-las-piezas-en-el-catálogo","Paso 1 · Ten las piezas en el catálogo",[117,156,157,158,161,162,165,166,170],{},"Cada pieza que cita la venta tiene que existir en el catálogo de tu empresa. El\n",[159,160,37],"a",{"href":38}," dice qué pieza va en qué campo de la venta,\ny ",[159,163,164],{"href":55},"Sincronizar tu catálogo"," cómo crearla o actualizarla con tu\n",[167,168,169],"code",{},"internalId"," y guardar su id de Openbox Cloud.",[151,172,174],{"id":173},"paso-2-crea-la-venta-con-referencias","Paso 2 · Crea la venta con referencias",[117,176,177,178,181,182,184],{},"La referencia es el id de Openbox Cloud ",[120,179,180],{},"como texto",", en el mismo campo donde iría el objeto\n(",[159,183,33],{"href":34},"). Puedes mezclar: una referencia en un\ncampo y un objeto en otro.",[186,187,193],"pre",{"className":188,"code":189,"filename":190,"language":191,"meta":192,"style":192},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"settings\": { \"notify\": \"EMAIL\", \"internalId\": \"VTA-0002\" },\n  \"data\": {\n    \"header\": {\n      \"documentType\": \"CCF\",\n      \"customer\": \"0a1b2c3d-1111-9999-0000-123456789abc\",\n      \"paymentCondition\": \"5e6f7a8b-2222-9999-0000-123456789abc\",\n      \"invoicesSeller\": \"9c0d1e2f-3333-9999-0000-123456789abc\"\n    },\n    \"details\": [\n      { \"service\": \"4b5c6d7e-4444-9999-0000-123456789abc\", \"product\": null, \"quantity\": 1 }\n    ]\n  }\n}\n","venta.json (fragmento)","json","",[167,194,195,204,263,278,293,317,338,359,379,385,400,451,457,463],{"__ignoreMap":192},[196,197,200],"span",{"class":198,"line":199},"line",1,[196,201,203],{"class":202},"sMK4o","{\n",[196,205,207,210,214,217,220,223,226,230,232,234,236,240,242,245,247,249,251,253,255,258,260],{"class":198,"line":206},2,[196,208,209],{"class":202},"  \"",[196,211,213],{"class":212},"spNyl","settings",[196,215,216],{"class":202},"\"",[196,218,219],{"class":202},":",[196,221,222],{"class":202}," {",[196,224,225],{"class":202}," \"",[196,227,229],{"class":228},"sBMFI","notify",[196,231,216],{"class":202},[196,233,219],{"class":202},[196,235,225],{"class":202},[196,237,239],{"class":238},"sfazB","EMAIL",[196,241,216],{"class":202},[196,243,244],{"class":202},",",[196,246,225],{"class":202},[196,248,169],{"class":228},[196,250,216],{"class":202},[196,252,219],{"class":202},[196,254,225],{"class":202},[196,256,257],{"class":238},"VTA-0002",[196,259,216],{"class":202},[196,261,262],{"class":202}," },\n",[196,264,266,268,271,273,275],{"class":198,"line":265},3,[196,267,209],{"class":202},[196,269,270],{"class":212},"data",[196,272,216],{"class":202},[196,274,219],{"class":202},[196,276,277],{"class":202}," {\n",[196,279,281,284,287,289,291],{"class":198,"line":280},4,[196,282,283],{"class":202},"    \"",[196,285,286],{"class":228},"header",[196,288,216],{"class":202},[196,290,219],{"class":202},[196,292,277],{"class":202},[196,294,296,299,303,305,307,309,312,314],{"class":198,"line":295},5,[196,297,298],{"class":202},"      \"",[196,300,302],{"class":301},"sbssI","documentType",[196,304,216],{"class":202},[196,306,219],{"class":202},[196,308,225],{"class":202},[196,310,311],{"class":238},"CCF",[196,313,216],{"class":202},[196,315,316],{"class":202},",\n",[196,318,320,322,325,327,329,331,334,336],{"class":198,"line":319},6,[196,321,298],{"class":202},[196,323,324],{"class":301},"customer",[196,326,216],{"class":202},[196,328,219],{"class":202},[196,330,225],{"class":202},[196,332,333],{"class":238},"0a1b2c3d-1111-9999-0000-123456789abc",[196,335,216],{"class":202},[196,337,316],{"class":202},[196,339,341,343,346,348,350,352,355,357],{"class":198,"line":340},7,[196,342,298],{"class":202},[196,344,345],{"class":301},"paymentCondition",[196,347,216],{"class":202},[196,349,219],{"class":202},[196,351,225],{"class":202},[196,353,354],{"class":238},"5e6f7a8b-2222-9999-0000-123456789abc",[196,356,216],{"class":202},[196,358,316],{"class":202},[196,360,362,364,367,369,371,373,376],{"class":198,"line":361},8,[196,363,298],{"class":202},[196,365,366],{"class":301},"invoicesSeller",[196,368,216],{"class":202},[196,370,219],{"class":202},[196,372,225],{"class":202},[196,374,375],{"class":238},"9c0d1e2f-3333-9999-0000-123456789abc",[196,377,378],{"class":202},"\"\n",[196,380,382],{"class":198,"line":381},9,[196,383,384],{"class":202},"    },\n",[196,386,388,390,393,395,397],{"class":198,"line":387},10,[196,389,283],{"class":202},[196,391,392],{"class":228},"details",[196,394,216],{"class":202},[196,396,219],{"class":202},[196,398,399],{"class":202}," [\n",[196,401,403,406,408,411,413,415,417,420,422,424,426,429,431,433,436,438,441,443,445,448],{"class":198,"line":402},11,[196,404,405],{"class":202},"      {",[196,407,225],{"class":202},[196,409,410],{"class":301},"service",[196,412,216],{"class":202},[196,414,219],{"class":202},[196,416,225],{"class":202},[196,418,419],{"class":238},"4b5c6d7e-4444-9999-0000-123456789abc",[196,421,216],{"class":202},[196,423,244],{"class":202},[196,425,225],{"class":202},[196,427,428],{"class":301},"product",[196,430,216],{"class":202},[196,432,219],{"class":202},[196,434,435],{"class":202}," null,",[196,437,225],{"class":202},[196,439,440],{"class":301},"quantity",[196,442,216],{"class":202},[196,444,219],{"class":202},[196,446,447],{"class":301}," 1",[196,449,450],{"class":202}," }\n",[196,452,454],{"class":198,"line":453},12,[196,455,456],{"class":202},"    ]\n",[196,458,460],{"class":198,"line":459},13,[196,461,462],{"class":202},"  }\n",[196,464,466],{"class":198,"line":465},14,[196,467,468],{"class":202},"}\n",[186,470,475],{"className":471,"code":472,"filename":473,"language":474,"meta":192,"style":192},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X POST \"$OPENBOX_API_URL\u002Fpartners\u002Fv1\u002Finvoices\" \\\n  -H 'Authorization: Bearer \u003CTOKEN>' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d @venta.json\n","Terminal","bash",[167,476,477,502,518,531],{"__ignoreMap":192},[196,478,479,482,485,488,490,494,497,499],{"class":198,"line":199},[196,480,481],{"class":228},"curl",[196,483,484],{"class":238}," -X",[196,486,487],{"class":238}," POST",[196,489,225],{"class":202},[196,491,493],{"class":492},"sTEyZ","$OPENBOX_API_URL",[196,495,496],{"class":238},"\u002Fpartners\u002Fv1\u002Finvoices",[196,498,216],{"class":202},[196,500,501],{"class":492}," \\\n",[196,503,504,507,510,513,516],{"class":198,"line":206},[196,505,506],{"class":238},"  -H",[196,508,509],{"class":202}," '",[196,511,512],{"class":238},"Authorization: Bearer \u003CTOKEN>",[196,514,515],{"class":202},"'",[196,517,501],{"class":492},[196,519,520,522,524,527,529],{"class":198,"line":265},[196,521,506],{"class":238},[196,523,509],{"class":202},[196,525,526],{"class":238},"Content-Type: application\u002Fjson",[196,528,515],{"class":202},[196,530,501],{"class":492},[196,532,533,536],{"class":198,"line":280},[196,534,535],{"class":238},"  -d",[196,537,538],{"class":238}," @venta.json\n",[117,540,541,542,545],{},"Los tipos de documento y la respuesta son los mismos de\n",[159,543,544],{"href":63},"Vender con payload completo","; el esquema completo, campo\npor campo, está en la Referencia.",[151,547,549],{"id":548},"dos-modos-calculado-y-precalculado","Dos modos: calculado y precalculado",[117,551,552,553,556],{},"Lo que envíes en ",[167,554,555],{},"totals"," decide el modo.",[558,559,561],"h3",{"id":560},"modo-calculado-sin-montos","Modo calculado (sin montos)",[117,563,564,565,568,569,572,573,575,576,579,580,579,583,586,587,590],{},"Omite todos los montos de línea y de totales y Openbox Cloud los calcula con el mismo cálculo de la\naplicación web. Toda línea va por referencia; el ",[167,566,567],{},"price"," es opcional (sin él, se usa el precio del\ncatálogo vigente) y el ",[167,570,571],{},"sellingType",", si lo envías, debe ser el del catálogo. En ",[167,574,555],{}," solo puedes\nenviar ",[167,577,578],{},"descuNoSuj",", ",[167,581,582],{},"descuExenta",[167,584,585],{},"descuGravada"," e ",[167,588,589],{},"ivaRete1",". La FEX solo admite servicios.",[558,592,594],{"id":593},"modo-precalculado-con-montos","Modo precalculado (con montos)",[117,596,597,598,601],{},"Envías todos los montos y Openbox Cloud los verifica al centavo, con las reglas de\n",[159,599,544],{"href":600},"\u002Fguias\u002Frecetas\u002Fvender-con-payload-completo#modo-precalculado-tus-montos-verificados-al-centavo",".",[151,603,605],{"id":604},"qué-se-rechaza-antes-de-escribir","Qué se rechaza antes de escribir",[117,607,608,609,612],{},"Una venta por referencias nunca modifica el catálogo. Estos cuatro tipos de ",[167,610,611],{},"400"," llegan antes de\nescribir nada y de llamar al MH:",[614,615,616,626,637,650],"ol",{},[132,617,618,621,622,625],{},[120,619,620],{},"Validación",": la petición no cumple el contrato; ",[167,623,624],{},"message"," nombra el campo.",[132,627,628,633,634,636],{},[120,629,630],{},[167,631,632],{},"REFERENCE_NOT_FOUND",": una referencia no existe en tu empresa o fue eliminada; ",[167,635,624],{},"\nnombra el recurso.",[132,638,639,644,645,647,648,625],{},[120,640,641],{},[167,642,643],{},"INSUFFICIENT_DATA_TO_CALCULATE",": faltan datos para el modo (por ejemplo, un solo monto en\n",[167,646,555],{},", o una línea como objeto en el modo calculado); ",[167,649,624],{},[132,651,652,655,656,658],{},[120,653,654],{},"Monto que no coincide",": ",[167,657,624],{}," nombra el campo, lo que enviaste y el valor correcto.",[117,660,661,662,665,666,668,669,601],{},"Crear y anular una venta exigen el módulo ",[120,663,664],{},"Facturación"," en el perfil de tu llave: ver\n",[159,667,41],{"href":42},". Si tu integración hoy envía objetos, el paso a paso\npara cambiar está en ",[159,670,78],{"href":79},[672,673,674],"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 .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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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 .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":192,"searchDepth":206,"depth":206,"links":676},[677,678,679,683],{"id":153,"depth":206,"text":154},{"id":173,"depth":206,"text":174},{"id":548,"depth":206,"text":549,"children":680},[681,682],{"id":560,"depth":265,"text":561},{"id":593,"depth":265,"text":594},{"id":604,"depth":206,"text":605},"Crea primero el catálogo y luego vende citando cada registro por su UUID de Openbox Cloud.","md",null,{},{"title":58},{"title":104,"description":684},"FCvOdxjUSmB8WtDq2xbj0rZT8_YoqLodvCiC5BRufGs",[692,694],{"title":54,"path":55,"stem":56,"description":693,"children":-1},"Crea o actualiza cada registro del catálogo con tu internalId como llave, sin duplicarlo.",{"title":62,"path":63,"stem":64,"description":695,"children":-1},"La venta lleva el cliente, las líneas y los totales completos, cada registro como objeto.",1795295097666]