[{"data":1,"prerenderedAt":754},["ShallowReactive",2],{"navigation_docs":3,"-guias-recetas-sincronizar-catalogo":102,"-guias-recetas-sincronizar-catalogo-surround":749},[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":742,"extension":743,"links":744,"meta":745,"navigation":746,"path":55,"seo":747,"stem":56,"__hash__":748},"docs\u002F1.guias\u002F3.recetas\u002F1.sincronizar-catalogo.md","Sincronizar tu catálogo",{"type":106,"value":107,"toc":732},"minimark",[108,117,127,134,139,191,201,205,208,211,277,283,286,367,373,377,394,398,401,404,454,467,470,538,549,571,575,583,723,728],[109,110,111,112,116],"p",{},"Sincronizar deja en Openbox Cloud los registros de tu sistema (clientes, proveedores, servicios,\nproductos, vendedores, zonas y condiciones de pago) para que tus ventas y compras los citen por su\nid. Se hace registro por registro, con tu ",[113,114,115],"code",{},"internalId"," como llave.",[109,118,119,120,123,124,126],{},"Antes de empezar conviene leer ",[121,122,29],"a",{"href":30}," y el\n",[121,125,37],{"href":38},", que dice qué pieza usa cada documento y en\nqué campo. Los ejemplos usan clientes; los ocho recursos funcionan igual (tabla al final).",[128,129,131,132],"h2",{"id":130},"paso-1-busca-el-registro-por-tu-internalid","Paso 1 · Busca el registro por tu ",[113,133,115],{},[135,136,138],"insignia-operacion",{"id":137},"partnersV1CustomersGetMany","Disponible",[140,141,147],"pre",{"className":142,"code":143,"filename":144,"language":145,"meta":146,"style":146},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl \"$OPENBOX_API_URL\u002Fpartners\u002Fv1\u002Fcustomers?internalId=CLI-0001\" \\\n  -H 'Authorization: Bearer \u003CTOKEN>'\n","Terminal","bash","",[113,148,149,176],{"__ignoreMap":146},[150,151,154,158,162,166,170,173],"span",{"class":152,"line":153},"line",1,[150,155,157],{"class":156},"sBMFI","curl",[150,159,161],{"class":160},"sMK4o"," \"",[150,163,165],{"class":164},"sTEyZ","$OPENBOX_API_URL",[150,167,169],{"class":168},"sfazB","\u002Fpartners\u002Fv1\u002Fcustomers?internalId=CLI-0001",[150,171,172],{"class":160},"\"",[150,174,175],{"class":164}," \\\n",[150,177,179,182,185,188],{"class":152,"line":178},2,[150,180,181],{"class":168},"  -H",[150,183,184],{"class":160}," '",[150,186,187],{"class":168},"Authorization: Bearer \u003CTOKEN>",[150,189,190],{"class":160},"'\n",[109,192,193,196,197,200],{},[113,194,195],{},"data"," trae una lista: vacía si el registro no existe, o con el registro y su ",[113,198,199],{},"id"," de Openbox Cloud.",[128,202,204],{"id":203},"paso-2-si-existe-actualízalo","Paso 2 · Si existe, actualízalo",[135,206,138],{"id":207},"partnersV1CustomersUpdateSingle",[109,209,210],{},"Envía solo los campos que cambian: la actualización cambia el registro en parte y conserva el resto.",[140,212,214],{"className":142,"code":213,"filename":144,"language":145,"meta":146,"style":146},"curl -X PATCH \"$OPENBOX_API_URL\u002Fpartners\u002Fv1\u002Fcustomers\u002F\u003CID_DEL_CLIENTE>\" \\\n  -H 'Authorization: Bearer \u003CTOKEN>' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"shortName\":\"Cliente Ejemplo\"}'\n",[113,215,216,237,250,264],{"__ignoreMap":146},[150,217,218,220,223,226,228,230,233,235],{"class":152,"line":153},[150,219,157],{"class":156},[150,221,222],{"class":168}," -X",[150,224,225],{"class":168}," PATCH",[150,227,161],{"class":160},[150,229,165],{"class":164},[150,231,232],{"class":168},"\u002Fpartners\u002Fv1\u002Fcustomers\u002F\u003CID_DEL_CLIENTE>",[150,234,172],{"class":160},[150,236,175],{"class":164},[150,238,239,241,243,245,248],{"class":152,"line":178},[150,240,181],{"class":168},[150,242,184],{"class":160},[150,244,187],{"class":168},[150,246,247],{"class":160},"'",[150,249,175],{"class":164},[150,251,253,255,257,260,262],{"class":152,"line":252},3,[150,254,181],{"class":168},[150,256,184],{"class":160},[150,258,259],{"class":168},"Content-Type: application\u002Fjson",[150,261,247],{"class":160},[150,263,175],{"class":164},[150,265,267,270,272,275],{"class":152,"line":266},4,[150,268,269],{"class":168},"  -d",[150,271,184],{"class":160},[150,273,274],{"class":168},"{\"shortName\":\"Cliente Ejemplo\"}",[150,276,190],{"class":160},[128,278,280,281],{"id":279},"paso-3-si-no-existe-créalo-con-tu-internalid","Paso 3 · Si no existe, créalo con tu ",[113,282,115],{},[135,284,138],{"id":285},"partnersV1CustomersCreateSingle",[140,287,292],{"className":288,"code":289,"filename":290,"language":291,"meta":146,"style":146},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"internalId\": \"CLI-0001\",\n  \"name\": \"Cliente Ejemplo, S.A. de C.V.\",\n  \"shortName\": \"Cliente Ejemplo\"\n}\n","cliente.json (fragmento)","json",[113,293,294,299,322,342,361],{"__ignoreMap":146},[150,295,296],{"class":152,"line":153},[150,297,298],{"class":160},"{\n",[150,300,301,304,307,309,312,314,317,319],{"class":152,"line":178},[150,302,303],{"class":160},"  \"",[150,305,115],{"class":306},"spNyl",[150,308,172],{"class":160},[150,310,311],{"class":160},":",[150,313,161],{"class":160},[150,315,316],{"class":168},"CLI-0001",[150,318,172],{"class":160},[150,320,321],{"class":160},",\n",[150,323,324,326,329,331,333,335,338,340],{"class":152,"line":252},[150,325,303],{"class":160},[150,327,328],{"class":306},"name",[150,330,172],{"class":160},[150,332,311],{"class":160},[150,334,161],{"class":160},[150,336,337],{"class":168},"Cliente Ejemplo, S.A. de C.V.",[150,339,172],{"class":160},[150,341,321],{"class":160},[150,343,344,346,349,351,353,355,358],{"class":152,"line":266},[150,345,303],{"class":160},[150,347,348],{"class":306},"shortName",[150,350,172],{"class":160},[150,352,311],{"class":160},[150,354,161],{"class":160},[150,356,357],{"class":168},"Cliente Ejemplo",[150,359,360],{"class":160},"\"\n",[150,362,364],{"class":152,"line":363},5,[150,365,366],{"class":160},"}\n",[109,368,369,370,372],{},"El esquema completo, con los campos fiscales y la dirección, está en la Referencia. La respuesta trae\nel ",[113,371,199],{}," de Openbox Cloud: guárdalo junto a tu registro, es lo que citarás en cada venta.",[128,374,376],{"id":375},"si-dos-procesos-crean-el-mismo-registro","Si dos procesos crean el mismo registro",[109,378,379,380,382,383,386,387,390,391,393],{},"Si otro proceso creó el mismo ",[113,381,115],{}," entre tu búsqueda y tu creación, la respuesta es ",[113,384,385],{},"409","\ncon el código ",[113,388,389],{},"INTERNAL_ID_DUPLICATED"," y no se crea nada. No repitas el crear: vuelve al paso 1 y\nactualiza el registro que ya existe. Ver ",[121,392,87],{"href":88},".",[128,395,397],{"id":396},"vendedores-y-zonas","Vendedores y zonas",[109,399,400],{},"Cada vendedor pertenece a una zona, así que sincroniza primero las zonas y después los vendedores.",[135,402,138],{"id":403},"partnersV1InvoicesZonesCreateSingle",[140,405,408],{"className":288,"code":406,"filename":407,"language":291,"meta":146,"style":146},"{\n  \"internalId\": \"ZON-0001\",\n  \"name\": \"Zona Ejemplo\"\n}\n","zona.json",[113,409,410,414,433,450],{"__ignoreMap":146},[150,411,412],{"class":152,"line":153},[150,413,298],{"class":160},[150,415,416,418,420,422,424,426,429,431],{"class":152,"line":178},[150,417,303],{"class":160},[150,419,115],{"class":306},[150,421,172],{"class":160},[150,423,311],{"class":160},[150,425,161],{"class":160},[150,427,428],{"class":168},"ZON-0001",[150,430,172],{"class":160},[150,432,321],{"class":160},[150,434,435,437,439,441,443,445,448],{"class":152,"line":252},[150,436,303],{"class":160},[150,438,328],{"class":306},[150,440,172],{"class":160},[150,442,311],{"class":160},[150,444,161],{"class":160},[150,446,447],{"class":168},"Zona Ejemplo",[150,449,360],{"class":160},[150,451,452],{"class":152,"line":266},[150,453,366],{"class":160},[109,455,456,457,459,460,463,464,393],{},"La respuesta trae el ",[113,458,199],{}," de Openbox Cloud de la zona: es el ",[113,461,462],{},"\u003CID_DE_LA_ZONA>"," que el vendedor cita\nen ",[113,465,466],{},"zone",[135,468,138],{"id":469},"partnersV1InvoicesSellersCreateSingle",[140,471,474],{"className":288,"code":472,"filename":473,"language":291,"meta":146,"style":146},"{\n  \"internalId\": \"VEN-0001\",\n  \"name\": \"Vendedor Ejemplo\",\n  \"zone\": \"\u003CID_DE_LA_ZONA>\"\n}\n","vendedor.json (fragmento)",[113,475,476,480,499,518,534],{"__ignoreMap":146},[150,477,478],{"class":152,"line":153},[150,479,298],{"class":160},[150,481,482,484,486,488,490,492,495,497],{"class":152,"line":178},[150,483,303],{"class":160},[150,485,115],{"class":306},[150,487,172],{"class":160},[150,489,311],{"class":160},[150,491,161],{"class":160},[150,493,494],{"class":168},"VEN-0001",[150,496,172],{"class":160},[150,498,321],{"class":160},[150,500,501,503,505,507,509,511,514,516],{"class":152,"line":252},[150,502,303],{"class":160},[150,504,328],{"class":306},[150,506,172],{"class":160},[150,508,311],{"class":160},[150,510,161],{"class":160},[150,512,513],{"class":168},"Vendedor Ejemplo",[150,515,172],{"class":160},[150,517,321],{"class":160},[150,519,520,522,524,526,528,530,532],{"class":152,"line":266},[150,521,303],{"class":160},[150,523,466],{"class":306},[150,525,172],{"class":160},[150,527,311],{"class":160},[150,529,161],{"class":160},[150,531,462],{"class":168},[150,533,360],{"class":160},[150,535,536],{"class":152,"line":363},[150,537,366],{"class":160},[109,539,540,541,544,545,548],{},"Si la zona que citas no existe en tu empresa o fue eliminada, la respuesta es ",[113,542,543],{},"400"," con el código\n",[113,546,547],{},"REFERENCE_NOT_FOUND"," y no se crea ni se cambia nada: sincroniza la zona y repite el vendedor. Lo\nmismo vale al actualizar un vendedor con otra zona.",[109,550,551,552,554,555,557,558,560,561,564,565,568,569,393],{},"Una zona que tiene vendedores asignados, activos o inactivos, no se elimina: la respuesta es ",[113,553,385],{},"\nsin ",[113,556,113],{},". Elimina o cambia de zona a sus vendedores antes de eliminarla. Un vendedor responde\n",[113,559,466],{}," en ",[113,562,563],{},"null"," cuando no tiene zona asignada o cuando la que tenía fue eliminada: trátalo como\nvendedor sin zona y asígnale una con un ",[113,566,567],{},"PATCH"," que envíe ",[113,570,466],{},[128,572,574],{"id":573},"los-ocho-recursos","Los ocho recursos",[109,576,577,578,580,581,393],{},"Cada recurso tiene las mismas cinco operaciones: crear, listar (con filtro por ",[113,579,115],{},"),\nconsultar por id, actualizar en parte y eliminar. La insignia de cada una sale del contrato; qué\nsignifica cada insignia está en ",[121,582,45],{"href":46},[584,585,586,602],"table",{},[587,588,589],"thead",{},[590,591,592,596,599],"tr",{},[593,594,595],"th",{},"Recurso",[593,597,598],{},"Ruta",[593,600,601],{},"Crear",[603,604,605,620,635,650,665,679,693,708],"tbody",{},[590,606,607,611,616],{},[608,609,610],"td",{},"Clientes",[608,612,613],{},[113,614,615],{},"\u002Fpartners\u002Fv1\u002Fcustomers",[608,617,618],{},[135,619,138],{"id":285},[590,621,622,625,630],{},[608,623,624],{},"Proveedores",[608,626,627],{},[113,628,629],{},"\u002Fpartners\u002Fv1\u002Fproviders",[608,631,632],{},[135,633,138],{"id":634},"partnersV1ProvidersCreateSingle",[590,636,637,640,645],{},[608,638,639],{},"Servicios",[608,641,642],{},[113,643,644],{},"\u002Fpartners\u002Fv1\u002Fservices",[608,646,647],{},[135,648,138],{"id":649},"partnersV1ServicesCreateSingle",[590,651,652,655,660],{},[608,653,654],{},"Productos",[608,656,657],{},[113,658,659],{},"\u002Fpartners\u002Fv1\u002Fproducts",[608,661,662],{},[135,663,138],{"id":664},"partnersV1ProductsCreateSingle",[590,666,667,670,675],{},[608,668,669],{},"Vendedores",[608,671,672],{},[113,673,674],{},"\u002Fpartners\u002Fv1\u002Finvoices\u002Fsellers",[608,676,677],{},[135,678,138],{"id":469},[590,680,681,684,689],{},[608,682,683],{},"Zonas",[608,685,686],{},[113,687,688],{},"\u002Fpartners\u002Fv1\u002Finvoices\u002Fzones",[608,690,691],{},[135,692,138],{"id":403},[590,694,695,698,703],{},[608,696,697],{},"Condiciones de pago de venta",[608,699,700],{},[113,701,702],{},"\u002Fpartners\u002Fv1\u002Finvoices\u002Fpayment-conditions",[608,704,705],{},[135,706,138],{"id":707},"partnersV1InvoicesPaymentConditionsCreateSingle",[590,709,710,713,718],{},[608,711,712],{},"Condiciones de pago de compra",[608,714,715],{},[113,716,717],{},"\u002Fpartners\u002Fv1\u002Fpurchases\u002Fpayment-conditions",[608,719,720],{},[135,721,138],{"id":722},"partnersV1PurchasesPaymentConditionsCreateSingle",[109,724,725,726,393],{},"Qué módulo del perfil de tu llave exige cada recurso está en ",[121,727,41],{"href":42},[729,730,731],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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 pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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}",{"title":146,"searchDepth":178,"depth":178,"links":733},[734,736,737,739,740,741],{"id":130,"depth":178,"text":735},"Paso 1 · Busca el registro por tu internalId",{"id":203,"depth":178,"text":204},{"id":279,"depth":178,"text":738},"Paso 3 · Si no existe, créalo con tu internalId",{"id":375,"depth":178,"text":376},{"id":396,"depth":178,"text":397},{"id":573,"depth":178,"text":574},"Crea o actualiza cada registro del catálogo con tu internalId como llave, sin duplicarlo.","md",null,{},{"title":54},{"title":104,"description":742},"JoZV4PYFqx4tAk-oo3Cg9KwQ2RlRpn3LA4k2fyQo0MY",[750,752],{"title":45,"path":46,"stem":47,"description":751,"children":-1},"Qué significa la insignia de cada operación y qué responde una operación declarada que no atiende la petición.",{"title":58,"path":59,"stem":60,"description":753,"children":-1},"Crea primero el catálogo y luego vende citando cada registro por su UUID de Openbox Cloud.",1795293794014]