Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
  devopsandClaude Sonnet 5
|
1abc69825c | ||
|
devops
|
1e6009daf7 | ||
|
devopsandClaude Sonnet 5
|
7a95957945 | ||
|
gitea-actions
|
a973b2671e | ||
|
devops
|
bdd7c06a32 | ||
|
devops
|
0c356d6fbe | ||
|
devopsandClaude Sonnet 5
|
c507da8abc | ||
|
gitea-actions
|
e42d588514 | ||
|
devops
|
e2938248f8 | ||
|
devops
|
4992da394b | ||
|
devopsandClaude Sonnet 5
|
f2e0c02013 | ||
|
devops
|
d4716382d3 | ||
|
gitea-actions
|
f0b4245676 | ||
|
devops
|
e9e78e64c1 |
No files matched your search
@@ -33,7 +33,16 @@ ENV CI=true \
|
||||
EPAYCO_P_KEY=build-only-epayco-pkey \
|
||||
EPAYCO_ENV=sandbox \
|
||||
EPAYCO_RESPONSE_URL=http://localhost:8000/checkout/pse/return \
|
||||
EPAYCO_NOTIFY_URL=http://localhost:9000/hooks/payment/epayco_pse
|
||||
EPAYCO_NOTIFY_URL=http://localhost:9000/hooks/payment/epayco_pse \
|
||||
ENVIOCLICK_API_KEY=build-only-envioclick-key \
|
||||
ENVIOCLICK_SANDBOX=true \
|
||||
ENVIOCLICK_ORIGIN_DANE_CODE=11001000 \
|
||||
ENVIOCLICK_ORIGIN_ADDRESS="Calle 1 No 1-1" \
|
||||
ENVIOCLICK_ORIGIN_COMPANY="ARI Shopping" \
|
||||
ENVIOCLICK_ORIGIN_FIRST_NAME=ARI \
|
||||
ENVIOCLICK_ORIGIN_LAST_NAME=Shopping \
|
||||
ENVIOCLICK_ORIGIN_EMAIL=[email protected] \
|
||||
ENVIOCLICK_ORIGIN_PHONE=3000000000
|
||||
|
||||
COPY package.json package-lock.json .npmrc ./
|
||||
|
||||
|
||||
@@ -133,6 +133,45 @@ module.exports = defineConfig({
|
||||
},
|
||||
|
||||
modules: [
|
||||
// ADR 0009 §2 / EnvíoClick: defineConfig() ya registra por defecto
|
||||
// un modulo de fulfillment con el provider manual_manual
|
||||
// (confirmado leyendo @medusajs/utils/dist/common/define-config.js
|
||||
// directo) -- pero como este bloque propio comparte el mismo tipo de
|
||||
// modulo, transformModules() lo pisa por completo (indexa por
|
||||
// serviceName, el ultimo que llega gana), no lo mezcla. Por eso
|
||||
// manual_manual va explicito ACA tambien: si se omitiera, la
|
||||
// shipping option existente que ya usa ese provider se rompe en
|
||||
// silencio. envioclick-fulfillment implementa el mismo contrato
|
||||
// (AbstractFulfillmentProviderService) contra
|
||||
// developers.envioclickpro.com.co, verificado en vivo (no solo doc)
|
||||
// con una llamada de prueba real que devolvio tarifas reales de
|
||||
// varias transportadoras.
|
||||
{
|
||||
resolve: "@medusajs/medusa/fulfillment",
|
||||
options: {
|
||||
providers: [
|
||||
{
|
||||
resolve: "@medusajs/medusa/fulfillment-manual",
|
||||
id: "manual",
|
||||
},
|
||||
{
|
||||
resolve: "./src/modules/envioclick-fulfillment",
|
||||
id: "standard",
|
||||
options: {
|
||||
apiKey: required("ENVIOCLICK_API_KEY"),
|
||||
sandbox: process.env.ENVIOCLICK_SANDBOX !== "false",
|
||||
originDaneCode: process.env.ENVIOCLICK_ORIGIN_DANE_CODE || "11001000",
|
||||
originAddress: required("ENVIOCLICK_ORIGIN_ADDRESS"),
|
||||
originCompany: process.env.ENVIOCLICK_ORIGIN_COMPANY || "ARI Shopping",
|
||||
originFirstName: process.env.ENVIOCLICK_ORIGIN_FIRST_NAME || "ARI",
|
||||
originLastName: process.env.ENVIOCLICK_ORIGIN_LAST_NAME || "Shopping",
|
||||
originEmail: required("ENVIOCLICK_ORIGIN_EMAIL"),
|
||||
originPhone: required("ENVIOCLICK_ORIGIN_PHONE"),
|
||||
},
|
||||
},
|
||||
],
|
||||
},
|
||||
},
|
||||
{
|
||||
resolve: "@medusajs/medusa/file",
|
||||
options: {
|
||||
|
||||
+213
-1
@@ -13,7 +13,8 @@
|
||||
"@medusajs/cli": "2.18.0",
|
||||
"@medusajs/framework": "2.18.0",
|
||||
"@medusajs/medusa": "2.18.0",
|
||||
"@rokmohar/medusa-plugin-meilisearch": "^1.4.1"
|
||||
"@rokmohar/medusa-plugin-meilisearch": "^1.4.1",
|
||||
"epayco-sdk-node": "^1.4.4"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@swc/core": "^1.7.28",
|
||||
@@ -9200,6 +9201,15 @@
|
||||
"node": ">=4.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/component-emitter": {
|
||||
"version": "1.3.1",
|
||||
"resolved": "https://registry.npmjs.org/component-emitter/-/component-emitter-1.3.1.tgz",
|
||||
"integrity": "sha512-T0+barUSQRTUQASh8bx02dl+DhF54GtIDY13Y3m9oWTklKbb3Wv974meRpeZ3lp1JpLVECWWNHC4vaG2XHXouQ==",
|
||||
"license": "MIT",
|
||||
"funding": {
|
||||
"url": "https://github.com/sponsors/sindresorhus"
|
||||
}
|
||||
},
|
||||
"node_modules/compressible": {
|
||||
"version": "2.0.18",
|
||||
"resolved": "https://registry.npmjs.org/compressible/-/compressible-2.0.18.tgz",
|
||||
@@ -9363,6 +9373,12 @@
|
||||
"integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/cookiejar": {
|
||||
"version": "2.1.4",
|
||||
"resolved": "https://registry.npmjs.org/cookiejar/-/cookiejar-2.1.4.tgz",
|
||||
"integrity": "sha512-LDx6oHrK+PhzLKJU9j5S7/Y3jM/mUHvD/DeI1WQmJn652iPC5Y4TBzC9l+5OMOXlyTTA+SmVUPm0HQUwpD5Jqw==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/copy-to-clipboard": {
|
||||
"version": "3.3.3",
|
||||
"resolved": "https://registry.npmjs.org/copy-to-clipboard/-/copy-to-clipboard-3.3.3.tgz",
|
||||
@@ -9372,6 +9388,12 @@
|
||||
"toggle-selection": "^1.0.6"
|
||||
}
|
||||
},
|
||||
"node_modules/core-util-is": {
|
||||
"version": "1.0.3",
|
||||
"resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
|
||||
"integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/cors": {
|
||||
"version": "2.8.6",
|
||||
"resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz",
|
||||
@@ -9434,6 +9456,13 @@
|
||||
"node": ">= 8"
|
||||
}
|
||||
},
|
||||
"node_modules/crypto-js": {
|
||||
"version": "4.2.0",
|
||||
"resolved": "https://registry.npmjs.org/crypto-js/-/crypto-js-4.2.0.tgz",
|
||||
"integrity": "sha512-KALDyEYgpY+Rlob/iriUtjV6d5Eq+Y191A5g4UqLAi8CyGP9N1+FdVbkc1SxKc2r4YAYqG8JzO2KGL+AizD70Q==",
|
||||
"deprecated": "Active development of CryptoJS has been discontinued. This library is no longer maintained.",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/crypto-random-string": {
|
||||
"version": "2.0.0",
|
||||
"resolved": "https://registry.npmjs.org/crypto-random-string/-/crypto-random-string-2.0.0.tgz",
|
||||
@@ -9806,6 +9835,35 @@
|
||||
"node": ">= 0.8"
|
||||
}
|
||||
},
|
||||
"node_modules/epayco-sdk-node": {
|
||||
"version": "1.4.4",
|
||||
"resolved": "https://registry.npmjs.org/epayco-sdk-node/-/epayco-sdk-node-1.4.4.tgz",
|
||||
"integrity": "sha512-i6SpQru6Hwp096yxAVaD4lsV76ASB0cqAbJsvXQoc0leCsePHRjetV/9C1AASw8ZFbnkmTajw9DhWsAvjdTEFw==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"axios": "^1.8.2",
|
||||
"crypto-js": "^4.2.0",
|
||||
"debug": "2.6.9",
|
||||
"dotenv": "^16.3.1",
|
||||
"node-fetch": "^2.6.0",
|
||||
"superagent": "^3.7.0"
|
||||
}
|
||||
},
|
||||
"node_modules/epayco-sdk-node/node_modules/debug": {
|
||||
"version": "2.6.9",
|
||||
"resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
|
||||
"integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"ms": "2.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/epayco-sdk-node/node_modules/ms": {
|
||||
"version": "2.0.0",
|
||||
"resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
|
||||
"integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/es-define-property": {
|
||||
"version": "1.0.1",
|
||||
"resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
|
||||
@@ -10099,6 +10157,12 @@
|
||||
"integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/extend": {
|
||||
"version": "3.0.2",
|
||||
"resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz",
|
||||
"integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/fast-deep-equal": {
|
||||
"version": "3.1.3",
|
||||
"resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
|
||||
@@ -10292,6 +10356,16 @@
|
||||
"node": ">= 6"
|
||||
}
|
||||
},
|
||||
"node_modules/formidable": {
|
||||
"version": "1.2.6",
|
||||
"resolved": "https://registry.npmjs.org/formidable/-/formidable-1.2.6.tgz",
|
||||
"integrity": "sha512-KcpbcpuLNOwrEjnbpMC0gS+X8ciDoZE1kkqzat4a8vrprf+s9pKNQ/QIwWfbfs4ltgmFl3MD177SNTkve3BwGQ==",
|
||||
"deprecated": "Please upgrade to latest, formidable@v2 or formidable@v3! Check these notes: https://bit.ly/2ZEqIau",
|
||||
"license": "MIT",
|
||||
"funding": {
|
||||
"url": "https://ko-fi.com/tunnckoCore/commissions"
|
||||
}
|
||||
},
|
||||
"node_modules/forwarded": {
|
||||
"version": "0.2.0",
|
||||
"resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
|
||||
@@ -11207,6 +11281,12 @@
|
||||
"node": ">=0.10.0"
|
||||
}
|
||||
},
|
||||
"node_modules/isarray": {
|
||||
"version": "1.0.0",
|
||||
"resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
|
||||
"integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/isexe": {
|
||||
"version": "2.0.0",
|
||||
"resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
|
||||
@@ -12164,6 +12244,26 @@
|
||||
"node": ">= 8.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/node-fetch": {
|
||||
"version": "2.7.0",
|
||||
"resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz",
|
||||
"integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"whatwg-url": "^5.0.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": "4.x || >=6.0.0"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"encoding": "^0.1.0"
|
||||
},
|
||||
"peerDependenciesMeta": {
|
||||
"encoding": {
|
||||
"optional": true
|
||||
}
|
||||
}
|
||||
},
|
||||
"node_modules/node-gyp-build-optional-packages": {
|
||||
"version": "5.2.2",
|
||||
"resolved": "https://registry.npmjs.org/node-gyp-build-optional-packages/-/node-gyp-build-optional-packages-5.2.2.tgz",
|
||||
@@ -12924,6 +13024,12 @@
|
||||
"node": ">=6"
|
||||
}
|
||||
},
|
||||
"node_modules/process-nextick-args": {
|
||||
"version": "2.0.1",
|
||||
"resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
|
||||
"integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/prompts": {
|
||||
"version": "2.4.2",
|
||||
"resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz",
|
||||
@@ -14354,6 +14460,90 @@
|
||||
"node": ">= 6"
|
||||
}
|
||||
},
|
||||
"node_modules/superagent": {
|
||||
"version": "3.8.3",
|
||||
"resolved": "https://registry.npmjs.org/superagent/-/superagent-3.8.3.tgz",
|
||||
"integrity": "sha512-GLQtLMCoEIK4eDv6OGtkOoSMt3D+oq0y3dsxMuYuDvaNUvuT8eFBuLmfR0iYYzHC1e8hpzC6ZsxbuP6DIalMFA==",
|
||||
"deprecated": "Please upgrade to superagent v10.2.2+, see release notes at https://github.com/forwardemail/superagent/releases/tag/v10.2.2 - maintenance is supported by Forward Email @ https://forwardemail.net",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"component-emitter": "^1.2.0",
|
||||
"cookiejar": "^2.1.0",
|
||||
"debug": "^3.1.0",
|
||||
"extend": "^3.0.0",
|
||||
"form-data": "^2.3.1",
|
||||
"formidable": "^1.2.0",
|
||||
"methods": "^1.1.1",
|
||||
"mime": "^1.4.1",
|
||||
"qs": "^6.5.1",
|
||||
"readable-stream": "^2.3.5"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">= 4.0"
|
||||
}
|
||||
},
|
||||
"node_modules/superagent/node_modules/debug": {
|
||||
"version": "3.2.7",
|
||||
"resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz",
|
||||
"integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"ms": "^2.1.1"
|
||||
}
|
||||
},
|
||||
"node_modules/superagent/node_modules/form-data": {
|
||||
"version": "2.5.6",
|
||||
"resolved": "https://registry.npmjs.org/form-data/-/form-data-2.5.6.tgz",
|
||||
"integrity": "sha512-Ogz/E85h9tlfJzpI6TuFpGcHZFhLrb9Gw8wq9v40CxSCPnv7ahKr6Xgtkn0KYCDQJ8DNn5VoMO8EXr9V5PadyA==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"asynckit": "^0.4.0",
|
||||
"combined-stream": "^1.0.8",
|
||||
"es-set-tostringtag": "^2.1.0",
|
||||
"hasown": "^2.0.4",
|
||||
"mime-types": "^2.1.35",
|
||||
"safe-buffer": "^5.2.1"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">= 0.12"
|
||||
}
|
||||
},
|
||||
"node_modules/superagent/node_modules/readable-stream": {
|
||||
"version": "2.3.8",
|
||||
"resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
|
||||
"integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"core-util-is": "~1.0.0",
|
||||
"inherits": "~2.0.3",
|
||||
"isarray": "~1.0.0",
|
||||
"process-nextick-args": "~2.0.0",
|
||||
"safe-buffer": "~5.1.1",
|
||||
"string_decoder": "~1.1.1",
|
||||
"util-deprecate": "~1.0.1"
|
||||
}
|
||||
},
|
||||
"node_modules/superagent/node_modules/readable-stream/node_modules/safe-buffer": {
|
||||
"version": "5.1.2",
|
||||
"resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
|
||||
"integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/superagent/node_modules/string_decoder": {
|
||||
"version": "1.1.1",
|
||||
"resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
|
||||
"integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"safe-buffer": "~5.1.0"
|
||||
}
|
||||
},
|
||||
"node_modules/superagent/node_modules/string_decoder/node_modules/safe-buffer": {
|
||||
"version": "5.1.2",
|
||||
"resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
|
||||
"integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/supports-color": {
|
||||
"version": "7.2.0",
|
||||
"resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
|
||||
@@ -14635,6 +14825,12 @@
|
||||
"node": ">=0.6"
|
||||
}
|
||||
},
|
||||
"node_modules/tr46": {
|
||||
"version": "0.0.3",
|
||||
"resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
|
||||
"integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/triple-beam": {
|
||||
"version": "1.4.1",
|
||||
"resolved": "https://registry.npmjs.org/triple-beam/-/triple-beam-1.4.1.tgz",
|
||||
@@ -15099,6 +15295,22 @@
|
||||
"defaults": "^1.0.3"
|
||||
}
|
||||
},
|
||||
"node_modules/webidl-conversions": {
|
||||
"version": "3.0.1",
|
||||
"resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
|
||||
"integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==",
|
||||
"license": "BSD-2-Clause"
|
||||
},
|
||||
"node_modules/whatwg-url": {
|
||||
"version": "5.0.0",
|
||||
"resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz",
|
||||
"integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"tr46": "~0.0.3",
|
||||
"webidl-conversions": "^3.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/which": {
|
||||
"version": "2.0.2",
|
||||
"resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
|
||||
|
||||
@@ -0,0 +1,179 @@
|
||||
// EnvíoClick (ADR 0009 §2, ya anticipado desde el modelo de direcciones
|
||||
// del checkout): cotización y generación de guía real por peso/volumen,
|
||||
// reemplazando la tarifa fija de $15.000 COP. Contrato REST confirmado en
|
||||
// vivo contra la cuenta real del usuario (apiDoc real,
|
||||
// apidoc.envioclickpro.com.co/api_data.json -- la SPA de la doc no
|
||||
// renderiza sin JS, pero ese archivo generado por apidoc trae la spec
|
||||
// completa) y una llamada de prueba real que devolvió 200 con tarifas
|
||||
// reales de PIBOX/COORDINADORA/ENVIA/RAPPI/TCC.
|
||||
|
||||
const BASE_URL = "https://api.envioclickpro.com.co/api/v2";
|
||||
|
||||
export interface EnvioClickCredentials {
|
||||
apiKey: string;
|
||||
}
|
||||
|
||||
export interface EnvioClickPackage {
|
||||
weight: number;
|
||||
height: number;
|
||||
length: number;
|
||||
// "widht" es un typo real de la API (confirmado en el body de
|
||||
// /shipment de la doc oficial), no un error nuestro -- solo se usa acá,
|
||||
// en el request de /quotation el campo si se llama "width" (confirmado
|
||||
// tambien contra la doc real, son dos endpoints con esa inconsistencia).
|
||||
width: number;
|
||||
}
|
||||
|
||||
export interface EnvioClickRate {
|
||||
idRate: number;
|
||||
idProduct: number;
|
||||
product: string;
|
||||
idCarrier: number;
|
||||
carrier: string;
|
||||
flete: number;
|
||||
minimumInsurance: number;
|
||||
extraInsurance: number;
|
||||
deliveryDays: number;
|
||||
cod: boolean;
|
||||
}
|
||||
|
||||
export interface EnvioClickAddress {
|
||||
daneCode: string;
|
||||
address: string;
|
||||
}
|
||||
|
||||
async function envioclickRequest(
|
||||
credentials: EnvioClickCredentials,
|
||||
path: string,
|
||||
body: Record<string, unknown>,
|
||||
): Promise<Record<string, unknown>> {
|
||||
const response = await fetch(`${BASE_URL}${path}`, {
|
||||
method: "POST",
|
||||
headers: {
|
||||
"Content-Type": "application/json",
|
||||
// Header real confirmado contra la doc oficial y una llamada en
|
||||
// vivo -- "Authorization" a secas (sin "Bearer"), NO
|
||||
// "AuthorizationKey" como usaba el plugin de WordPress de
|
||||
// referencia (ese era para la API v1, desactualizada).
|
||||
Authorization: credentials.apiKey,
|
||||
},
|
||||
body: JSON.stringify(body),
|
||||
});
|
||||
const text = await response.text();
|
||||
let json: Record<string, unknown>;
|
||||
try {
|
||||
json = JSON.parse(text);
|
||||
} catch {
|
||||
throw new Error(`Respuesta no-JSON de EnvíoClick (HTTP ${response.status}): ${text.slice(0, 300)}`);
|
||||
}
|
||||
if (json.status !== "OK") {
|
||||
throw new Error(`EnvíoClick respondió con error: ${JSON.stringify(json).slice(0, 400)}`);
|
||||
}
|
||||
return json;
|
||||
}
|
||||
|
||||
// Solo 1 paquete por cotizacion (limite real documentado y confirmado:
|
||||
// "min 1, max 1" -- cada vez menos transportadoras ofrecen multi-paquete).
|
||||
export async function quoteShipment(
|
||||
credentials: EnvioClickCredentials,
|
||||
params: {
|
||||
pkg: EnvioClickPackage;
|
||||
description: string;
|
||||
contentValue: number;
|
||||
origin: EnvioClickAddress;
|
||||
destination: EnvioClickAddress;
|
||||
},
|
||||
): Promise<EnvioClickRate[]> {
|
||||
const json = await envioclickRequest(credentials, "/quotation", {
|
||||
packages: [params.pkg],
|
||||
description: params.description,
|
||||
contentValue: params.contentValue,
|
||||
origin: params.origin,
|
||||
destination: params.destination,
|
||||
});
|
||||
const data = json.data as Record<string, unknown>;
|
||||
return (data.rates as EnvioClickRate[]) ?? [];
|
||||
}
|
||||
|
||||
export interface EnvioClickPerson {
|
||||
company: string;
|
||||
firstName: string;
|
||||
lastName: string;
|
||||
email: string;
|
||||
phone: string;
|
||||
address: string;
|
||||
suburb: string;
|
||||
crossStreet: string;
|
||||
reference: string;
|
||||
daneCode: string;
|
||||
}
|
||||
|
||||
export interface CreateGuideResult {
|
||||
guide: string;
|
||||
url: string;
|
||||
tracker: string;
|
||||
idOrder: number;
|
||||
}
|
||||
|
||||
export async function createGuide(
|
||||
credentials: EnvioClickCredentials,
|
||||
sandbox: boolean,
|
||||
params: {
|
||||
idRate: number;
|
||||
myShipmentReference: string;
|
||||
externalOrderId: string;
|
||||
pkg: EnvioClickPackage;
|
||||
description: string;
|
||||
contentValue: number;
|
||||
origin: EnvioClickPerson;
|
||||
destination: EnvioClickPerson;
|
||||
},
|
||||
): Promise<CreateGuideResult> {
|
||||
// /shipment_sandbox es el UNICO endpoint con modo de pruebas real (la
|
||||
// cotizacion siempre usa tarifas reales de las transportadoras, no
|
||||
// tiene sandbox) -- confirmado en la doc oficial ("Deberás cambiar a
|
||||
// la URL de producción para que puedas generar guías reales").
|
||||
const path = sandbox ? "/shipment_sandbox" : "/shipment";
|
||||
const json = await envioclickRequest(credentials, path, {
|
||||
idRate: params.idRate,
|
||||
myShipmentReference: params.myShipmentReference,
|
||||
external_order_id: params.externalOrderId,
|
||||
requestPickup: false,
|
||||
pickupDate: new Date().toISOString().slice(0, 10),
|
||||
insurance: false,
|
||||
description: params.description,
|
||||
contentValue: params.contentValue,
|
||||
packages: [
|
||||
{
|
||||
weight: params.pkg.weight,
|
||||
height: params.pkg.height,
|
||||
length: params.pkg.length,
|
||||
widht: params.pkg.width,
|
||||
},
|
||||
],
|
||||
origin: params.origin,
|
||||
destination: params.destination,
|
||||
});
|
||||
const data = json.data as Record<string, unknown>;
|
||||
return {
|
||||
guide: String(data.guide ?? ""),
|
||||
url: String(data.url ?? ""),
|
||||
tracker: String(data.tracker ?? ""),
|
||||
idOrder: Number(data.idOrder ?? 0),
|
||||
};
|
||||
}
|
||||
|
||||
// Hasta 50 ordenes por llamada (limite real documentado).
|
||||
export async function cancelGuides(credentials: EnvioClickCredentials, idOrders: number[]): Promise<void> {
|
||||
await envioclickRequest(credentials, "cancellation/batch/order", { idOrders });
|
||||
}
|
||||
|
||||
// código DANE estandar (5 digitos: 2 de departamento + 3 de municipio,
|
||||
// ej. 11001 = Bogota, 5001 = Medellin -- mismo id que ya usa
|
||||
// lib/data/colombia.ts del storefront, confirmado contra su propio
|
||||
// comentario) con el padding real que espera EnvioClick (8 caracteres,
|
||||
// confirmado contra su propio ejemplo real: "11001000" para Bogota =
|
||||
// "11001" + "000").
|
||||
export function toEnvioClickDaneCode(divipolaCityId: number): string {
|
||||
return `${String(divipolaCityId).padStart(5, "0")}000`;
|
||||
}
|
||||
@@ -0,0 +1,6 @@
|
||||
import { ModuleProvider, Modules } from "@medusajs/framework/utils";
|
||||
import EnvioClickFulfillmentService from "./service";
|
||||
|
||||
export default ModuleProvider(Modules.FULFILLMENT, {
|
||||
services: [EnvioClickFulfillmentService],
|
||||
});
|
||||
@@ -0,0 +1,275 @@
|
||||
import { AbstractFulfillmentProviderService } from "@medusajs/framework/utils";
|
||||
import type {
|
||||
CalculatedShippingOptionPrice,
|
||||
CalculateShippingOptionPriceContext,
|
||||
CalculateShippingOptionPriceDTO,
|
||||
CreateFulfillmentResult,
|
||||
CreateShippingOptionDTO,
|
||||
FulfillmentDTO,
|
||||
FulfillmentItemDTO,
|
||||
FulfillmentOption,
|
||||
FulfillmentOrderDTO,
|
||||
Logger,
|
||||
ValidateFulfillmentDataContext,
|
||||
} from "@medusajs/framework/types";
|
||||
import { cancelGuides, createGuide, quoteShipment, toEnvioClickDaneCode } from "../../lib/envioclick";
|
||||
import { DEFAULT_PACKAGE, FALLBACK_PRICE_COP, type EnvioClickOptions } from "./types";
|
||||
|
||||
type InjectedDependencies = {
|
||||
logger: Logger;
|
||||
};
|
||||
|
||||
// Contexto minimo compartido entre calculatePrice/createFulfillment --
|
||||
// ambos necesitan lo mismo (id DIVIPOLA de la ciudad destino, guardado
|
||||
// como metadata en la direccion por el checkout -- ver ADR 0009 y
|
||||
// checkout-client.tsx del storefront) y el paquete agregado del pedido.
|
||||
interface AddressLike {
|
||||
metadata?: Record<string, unknown> | null;
|
||||
address_1?: string | null;
|
||||
first_name?: string | null;
|
||||
last_name?: string | null;
|
||||
phone?: string | null;
|
||||
email?: string | null;
|
||||
}
|
||||
|
||||
function destinationDaneCode(address: AddressLike | null | undefined): string | null {
|
||||
const cityId = address?.metadata?.cityId;
|
||||
return typeof cityId === "number" ? toEnvioClickDaneCode(cityId) : null;
|
||||
}
|
||||
|
||||
// Agrega el carrito/orden a UN solo paquete (EnvioClick solo acepta 1 por
|
||||
// cotizacion/guia, confirmado en la doc real: "min 1, max 1"). Si algun
|
||||
// item no tiene peso real cargado (hoy NINGUN producto lo tiene, ver
|
||||
// plan de implementacion), se usa el paquete de fallback conservador
|
||||
// completo en vez de mezclar datos reales con inventados a medias.
|
||||
function aggregatePackage(items: Array<{ quantity: number; variant?: { weight?: number | null } | null }>) {
|
||||
if (items.length === 0) return { ...DEFAULT_PACKAGE };
|
||||
let totalWeight = 0;
|
||||
for (const item of items) {
|
||||
const weight = item.variant?.weight;
|
||||
if (!weight) return { ...DEFAULT_PACKAGE };
|
||||
totalWeight += weight * item.quantity;
|
||||
}
|
||||
return { ...DEFAULT_PACKAGE, weight: totalWeight };
|
||||
}
|
||||
|
||||
export default class EnvioClickFulfillmentService extends AbstractFulfillmentProviderService {
|
||||
static identifier = "envioclick";
|
||||
|
||||
protected logger_: Logger;
|
||||
protected options_: EnvioClickOptions;
|
||||
|
||||
constructor(container: InjectedDependencies, options: EnvioClickOptions) {
|
||||
super();
|
||||
this.logger_ = container.logger;
|
||||
this.options_ = options;
|
||||
}
|
||||
|
||||
static validateOptions(options: Record<string, unknown>): void {
|
||||
for (const key of ["apiKey", "originDaneCode", "originAddress", "originCompany", "originFirstName", "originLastName", "originEmail", "originPhone"]) {
|
||||
if (!options[key]) {
|
||||
throw new Error(`envioclick-fulfillment: falta la opción "${key}" en medusa-config.ts`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
async getFulfillmentOptions(): Promise<FulfillmentOption[]> {
|
||||
// Una sola opcion: siempre toma la tarifa mas barata entre las
|
||||
// transportadoras que cotizan, mismo criterio que el plugin oficial
|
||||
// de WooCommerce de referencia ("toma el precio mas economico").
|
||||
return [{ id: "standard", name: "Envío nacional (calculado)" }];
|
||||
}
|
||||
|
||||
async validateFulfillmentData(
|
||||
optionData: Record<string, unknown>,
|
||||
data: Record<string, unknown>,
|
||||
_context: ValidateFulfillmentDataContext,
|
||||
): Promise<any> {
|
||||
return data;
|
||||
}
|
||||
|
||||
async validateOption(_data: Record<string, unknown>): Promise<boolean> {
|
||||
return true;
|
||||
}
|
||||
|
||||
async canCalculate(_data: CreateShippingOptionDTO): Promise<boolean> {
|
||||
return true;
|
||||
}
|
||||
|
||||
// Se invoca en vivo durante el checkout cada vez que se piden/refrescan
|
||||
// las shipping options del carrito. Medusa advierte explicitamente que
|
||||
// un error acá bloquea el checkout entero -- por eso NUNCA se deja
|
||||
// propagar una excepcion: cualquier falla (red, ciudad sin id DIVIPOLA,
|
||||
// EnvioClick caido) cae al precio fijo que ya se usaba antes de esta
|
||||
// integracion, para no romper la compra.
|
||||
async calculatePrice(
|
||||
optionData: CalculateShippingOptionPriceDTO["optionData"],
|
||||
_data: CalculateShippingOptionPriceDTO["data"],
|
||||
context: CalculateShippingOptionPriceContext,
|
||||
): Promise<CalculatedShippingOptionPrice> {
|
||||
const fallback: CalculatedShippingOptionPrice = {
|
||||
calculated_amount: FALLBACK_PRICE_COP,
|
||||
is_calculated_price_tax_inclusive: false,
|
||||
};
|
||||
try {
|
||||
const address = context.shipping_address as AddressLike | undefined;
|
||||
const daneCode = destinationDaneCode(address);
|
||||
if (!daneCode) {
|
||||
this.logger_.warn("envioclick-fulfillment: dirección sin id DIVIPOLA en metadata, usando precio fijo de respaldo");
|
||||
return fallback;
|
||||
}
|
||||
|
||||
const items = (context.items ?? []) as Array<{ quantity: number; variant?: { weight?: number | null } | null }>;
|
||||
const pkg = aggregatePackage(items);
|
||||
|
||||
const rates = await quoteShipment(
|
||||
{ apiKey: this.options_.apiKey },
|
||||
{
|
||||
pkg,
|
||||
description: "Pedido ARI Shopping",
|
||||
contentValue: 50000,
|
||||
origin: { daneCode: this.options_.originDaneCode, address: this.options_.originAddress },
|
||||
destination: { daneCode, address: address?.address_1 || "Dirección de entrega" },
|
||||
},
|
||||
);
|
||||
|
||||
if (rates.length === 0) return fallback;
|
||||
|
||||
const cheapest = rates.reduce((min, rate) =>
|
||||
rate.flete + rate.minimumInsurance < min.flete + min.minimumInsurance ? rate : min,
|
||||
);
|
||||
|
||||
return {
|
||||
calculated_amount: cheapest.flete + cheapest.minimumInsurance,
|
||||
is_calculated_price_tax_inclusive: false,
|
||||
};
|
||||
} catch (error) {
|
||||
this.logger_.warn(`envioclick-fulfillment: falló calculatePrice (${(error as Error).message}), usando precio fijo de respaldo`);
|
||||
return fallback;
|
||||
}
|
||||
}
|
||||
|
||||
// A diferencia de calculatePrice, acá SÍ se deja propagar el error --
|
||||
// el idRate de la cotización mostrada en checkout no se persiste en
|
||||
// ningún lado (CalculatedShippingOptionPrice no tiene un campo `data`
|
||||
// para eso, confirmado leyendo el tipo real), así que se vuelve a
|
||||
// cotizar en el momento de generar la guía (más correcto igual: el
|
||||
// fulfillment puede pasar horas/días después del checkout, un idRate
|
||||
// viejo podría estar vencido) y se reserva con la tarifa más barata de
|
||||
// esa cotización fresca.
|
||||
async createFulfillment(
|
||||
_data: Record<string, unknown>,
|
||||
_items: Partial<Omit<FulfillmentItemDTO, "fulfillment">>[],
|
||||
order: Partial<FulfillmentOrderDTO> | undefined,
|
||||
_fulfillment: Partial<Omit<FulfillmentDTO, "provider_id" | "data" | "items">>,
|
||||
): Promise<CreateFulfillmentResult> {
|
||||
const address = order?.shipping_address as AddressLike | undefined;
|
||||
const daneCode = destinationDaneCode(address);
|
||||
if (!daneCode) {
|
||||
throw new Error("envioclick-fulfillment: no se puede generar la guía sin un id DIVIPOLA en la dirección de envío.");
|
||||
}
|
||||
|
||||
const items = (order?.items ?? []) as unknown as Array<{ quantity: number; variant?: { weight?: number | null } | null }>;
|
||||
const pkg = aggregatePackage(items);
|
||||
|
||||
const rates = await quoteShipment(
|
||||
{ apiKey: this.options_.apiKey },
|
||||
{
|
||||
pkg,
|
||||
description: "Pedido ARI Shopping",
|
||||
contentValue: 50000,
|
||||
origin: { daneCode: this.options_.originDaneCode, address: this.options_.originAddress },
|
||||
destination: { daneCode, address: address?.address_1 || "Dirección de entrega" },
|
||||
},
|
||||
);
|
||||
if (rates.length === 0) {
|
||||
throw new Error("envioclick-fulfillment: no hay tarifas disponibles para generar la guía.");
|
||||
}
|
||||
const cheapest = rates.reduce((min, rate) =>
|
||||
rate.flete + rate.minimumInsurance < min.flete + min.minimumInsurance ? rate : min,
|
||||
);
|
||||
|
||||
const guide = await createGuide(
|
||||
{ apiKey: this.options_.apiKey },
|
||||
this.options_.sandbox,
|
||||
{
|
||||
idRate: cheapest.idRate,
|
||||
myShipmentReference: `Orden ${order?.display_id ?? order?.id ?? ""}`,
|
||||
externalOrderId: String(order?.id ?? ""),
|
||||
pkg,
|
||||
description: "Pedido ARI Shopping",
|
||||
contentValue: 50000,
|
||||
origin: {
|
||||
company: this.options_.originCompany,
|
||||
firstName: this.options_.originFirstName,
|
||||
lastName: this.options_.originLastName,
|
||||
email: this.options_.originEmail,
|
||||
phone: this.options_.originPhone,
|
||||
address: this.options_.originAddress,
|
||||
suburb: "N/A",
|
||||
crossStreet: "N/A",
|
||||
reference: "N/A",
|
||||
daneCode: this.options_.originDaneCode,
|
||||
},
|
||||
destination: {
|
||||
company: "N/A",
|
||||
firstName: address?.first_name || "Cliente",
|
||||
lastName: address?.last_name || "ARI",
|
||||
email: address?.email || order?.email || "[email protected]",
|
||||
phone: address?.phone || "0000000000",
|
||||
address: address?.address_1 || "Dirección de entrega",
|
||||
suburb: "N/A",
|
||||
crossStreet: "N/A",
|
||||
reference: "N/A",
|
||||
daneCode,
|
||||
},
|
||||
},
|
||||
);
|
||||
|
||||
return {
|
||||
data: {
|
||||
idOrder: guide.idOrder,
|
||||
tracker: guide.tracker,
|
||||
labelUrl: guide.url,
|
||||
},
|
||||
labels: [
|
||||
{
|
||||
tracking_number: guide.tracker,
|
||||
tracking_url: guide.url,
|
||||
label_url: guide.url,
|
||||
},
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
async cancelFulfillment(data: Record<string, unknown>): Promise<any> {
|
||||
const idOrder = data.idOrder;
|
||||
if (typeof idOrder !== "number") {
|
||||
this.logger_.warn("envioclick-fulfillment: cancelFulfillment sin idOrder guardado, no hay nada que cancelar en EnvíoClick");
|
||||
return { data };
|
||||
}
|
||||
await cancelGuides({ apiKey: this.options_.apiKey }, [idOrder]);
|
||||
return { data };
|
||||
}
|
||||
|
||||
async getFulfillmentDocuments(_data: Record<string, unknown>): Promise<never[]> {
|
||||
return [];
|
||||
}
|
||||
|
||||
async createReturnFulfillment(_fulfillment: Record<string, unknown>): Promise<CreateFulfillmentResult> {
|
||||
// Devoluciones no estan en alcance de esta primera version.
|
||||
throw new Error("envioclick-fulfillment: createReturnFulfillment no está implementado todavía.");
|
||||
}
|
||||
|
||||
async getReturnDocuments(_data: Record<string, unknown>): Promise<never[]> {
|
||||
return [];
|
||||
}
|
||||
|
||||
async getShipmentDocuments(_data: Record<string, unknown>): Promise<never[]> {
|
||||
return [];
|
||||
}
|
||||
|
||||
async retrieveDocuments(_fulfillmentData: Record<string, unknown>, _documentType: string): Promise<void> {
|
||||
return undefined;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
export interface EnvioClickOptions {
|
||||
apiKey: string;
|
||||
// El unico endpoint con modo de pruebas real es la generacion de guia
|
||||
// (ver src/lib/envioclick.ts) -- la cotizacion siempre usa tarifas
|
||||
// reales, no hay nada que alternar ahi.
|
||||
sandbox: boolean;
|
||||
// Datos de la bodega de origen -- la stock location real todavia no
|
||||
// tiene direccion fisica cargada ("Sin dirección física registrada"),
|
||||
// asi que estos vienen de config hasta que se cargue una real.
|
||||
originDaneCode: string;
|
||||
originAddress: string;
|
||||
originCompany: string;
|
||||
originFirstName: string;
|
||||
originLastName: string;
|
||||
originEmail: string;
|
||||
originPhone: string;
|
||||
}
|
||||
|
||||
// Precio de fallback cuando EnvíoClick falla o no hay peso/dimensiones
|
||||
// reales del pedido (hoy ningun producto los tiene cargados) -- mismo
|
||||
// valor que ya usaba la shipping option fija de ADR 0009, para no
|
||||
// empeorar la experiencia mientras no haya datos reales.
|
||||
export const FALLBACK_PRICE_COP = 15000;
|
||||
|
||||
// Paquete por defecto cuando algun item del carrito no tiene
|
||||
// peso/dimensiones reales -- conservador, no preciso. Ver nota en el
|
||||
// plan de implementacion: esto es una tarea de datos, no de codigo.
|
||||
export const DEFAULT_PACKAGE = {
|
||||
weight: 1,
|
||||
length: 20,
|
||||
height: 20,
|
||||
width: 20,
|
||||
};
|
||||
@@ -1,7 +1,10 @@
|
||||
# ADR 0009 — Checkout real (pago en línea + envíos) para ARI Shopping
|
||||
|
||||
**Estado:** aceptada — proveedor de pago decidido (PayU, §3);
|
||||
implementación real (credenciales, shipping options, código) pendiente
|
||||
**Estado:** aceptada — proveedor de pago decidido (PayU, §3); la
|
||||
implementación real terminó usando ePayco en vez de PayU (PayU LatAm
|
||||
quedó inviable, Rapyd se evaluó y se descartó sin código) y sumó
|
||||
EnvíoClick para envío calculado — ver [ADR 0010](./0010-pago-envio-reales-y-storefront.md)
|
||||
para el pivote completo y el estado final desplegado
|
||||
**Fecha:** 2026-08-28
|
||||
|
||||
## Contexto
|
||||
|
||||
@@ -0,0 +1,298 @@
|
||||
# ADR 0010 — Pago (ePayco PSE) y envío (EnvíoClick) reales; banner y buscador del storefront
|
||||
|
||||
**Estado:** aceptada — ambas integraciones desplegadas y verificadas en vivo (sandbox de cada proveedor); banner dinámico y buscador rediseñado desplegados
|
||||
**Fecha:** 2026-09-09
|
||||
|
||||
## Contexto
|
||||
|
||||
El ADR 0009 dejó **PayU** decidido como proveedor de pago de negocio y
|
||||
documentó la necesidad de un módulo custom (`AbstractPaymentProvider`)
|
||||
porque ningún plugin comunitario de Medusa sirve para la API real de
|
||||
PayU LatAm. Entre esa decisión y la implementación real pasaron dos
|
||||
correcciones más, ninguna prevista en el ADR original — este documento
|
||||
cierra esa cadena y agrega la segunda mitad de "checkout real" que el
|
||||
0009 dejó pendiente: el envío (EnvíoClick), más dos mejoras de UI del
|
||||
storefront relacionadas (banner dinámico, buscador) pedidas una vez que
|
||||
ambas integraciones ya estaban en producción.
|
||||
|
||||
## 1. Pago — de PayU a Rapyd a ePayco
|
||||
|
||||
### 1.1 PayU LatAm quedó inviable: Rapyd compró ese negocio
|
||||
|
||||
Al intentar registrar la cuenta de comercio en `developers.payulatam.com`
|
||||
(2026-08-29), el registro real redirige a **Rapyd** — confirmado en vivo
|
||||
contra `board.rapyd.net` con capturas de pantalla del propio usuario, no
|
||||
solo documentación. Investigación confirmó la causa: **Rapyd adquirió el
|
||||
negocio de PayU LatAm/África en 2023.** PayU LatAm como entidad separada
|
||||
con la API documentada en el ADR 0009 (`apiLogin`/`apiKey`/`accountId`)
|
||||
ya no es la vía de registro real para un comercio nuevo.
|
||||
|
||||
Se investigó y planificó por completo la alternativa Rapyd (API REST
|
||||
moderna, firma HMAC-SHA256, endpoint `/v1/payments` — arquitectura
|
||||
totalmente distinta a la de PayU LatAm clásico, no una migración menor
|
||||
de credenciales) pero **nunca se escribió código**: antes de implementar,
|
||||
el usuario planteó ePayco como alternativa y, al evaluarla, resultó
|
||||
preferible por costo/encaje — Rapyd quedó descartado en la etapa de plan,
|
||||
no de código.
|
||||
|
||||
### 1.2 Decisión final: ePayco
|
||||
|
||||
**Motivo de negocio:** ePayco es 100% propiedad de Davivienda desde 2024
|
||||
— mejor tarifa PSE dado que Davivienda ya es uno de los bancos
|
||||
disponibles del comercio (mismo dato de negocio del ADR 0009 §3:
|
||||
Davivienda, Lulo Bank, Banco de Bogotá).
|
||||
|
||||
**Hallazgo técnico no obvio, verificado en vivo, no en documentación:**
|
||||
ePayco tiene dos productos de integración distintos bajo la misma marca:
|
||||
|
||||
- Un producto nuevo tipo "Apify"/Web-Checkout (widget alojado).
|
||||
- La integración real de PSE que efectivamente se usó: la API
|
||||
"restpagos" / `secure.payco.co`, **más antigua**, que combina login con
|
||||
bearer token **más cifrado AES-CBC campo por campo** usando la llave
|
||||
privada del comercio como clave AES con IV en cero — un protocolo poco
|
||||
común que no vale la pena reimplementar a mano. Se optó por depender
|
||||
del paquete oficial `epayco-sdk-node` en vez de escribir el cliente
|
||||
HTTP propio (a diferencia de EnvíoClick, ver §2).
|
||||
|
||||
Nombres de método/campo reales del SDK, corregidos contra su código
|
||||
fuente instalado (no contra su propia documentación pública, que estaba
|
||||
desactualizada respecto al paquete):
|
||||
|
||||
- Lista de bancos PSE: `getBanks()` (la doc pública sugiere `pseBank()`,
|
||||
que no existe en el SDK real).
|
||||
- Confirmación de método: campo `method_confirmation` (la doc pública
|
||||
sugiere `metodoconfirmacion`).
|
||||
|
||||
**Implementación** (`commerce-backend/src/modules/epayco-pse/`,
|
||||
`src/lib/epayco.ts`): módulo de pago custom
|
||||
(`AbstractPaymentProvider`), estado `pending_authorization` tras iniciar
|
||||
el pago (mecanismo documentado de Medusa para métodos asíncronos —
|
||||
permite que el carrito complete en una orden "esperando confirmación" sin
|
||||
bloquear sobre la respuesta del banco), webhook nativo de Medusa en
|
||||
`/hooks/payment/epayco_pse` (sin subscriber custom — el
|
||||
`payment-webhook` + `process-payment-workflow` incluidos en el core ya
|
||||
completan la orden automáticamente al recibir la notificación).
|
||||
|
||||
**Verificado en vivo (2026-09):**
|
||||
- Credenciales reales del comercio (`P_CUST_ID_CLIENTE`, `P_KEY`,
|
||||
`PUBLIC_KEY`, `PRIVATE_KEY`) cargadas en el secret real del cluster.
|
||||
- Llamada real a `getBanks()` contra la API de ePayco devolvió el listado
|
||||
real de bancos PSE en modo sandbox.
|
||||
- El webhook `/hooks/payment/epayco_pse` es alcanzable desde afuera:
|
||||
`POST` externo contra `https://commerce.cruzcloud.net/hooks/payment/epayco_pse`
|
||||
responde `200 OK` (la firma inválida se maneja puertas adentro sin
|
||||
romper la respuesta HTTP) — cierra el riesgo de red que el ADR 0009 §2
|
||||
había señalado como pendiente de validar (mismo patrón de incidente ya
|
||||
documentado para otro servicio,
|
||||
`incidente-cloudflared-504-quic-2026-08.md`).
|
||||
|
||||
**Limitaciones conocidas y aceptadas, no bloqueantes:**
|
||||
- `refundPayment` tira un error explícito de "no implementado" — el
|
||||
endpoint real de reembolso nunca se verificó en vivo, se prefirió
|
||||
fallar ruidosamente a fingir éxito.
|
||||
- El nombre exacto del campo de la URL de redirección del banco en la
|
||||
respuesta de `bank.create()` se maneja de forma defensiva, probando
|
||||
varios nombres candidatos con un error explícito y el payload completo
|
||||
si ninguno matchea — **todavía no se probó con un pago PSE real de
|
||||
principio a fin** (solo `getBanks()` está confirmado en vivo). Ver §3
|
||||
para cómo cerrar esto desde el storefront real.
|
||||
- El comercio está en modo **sandbox** de ePayco (`EPAYCO_ENV: sandbox`
|
||||
en el ConfigMap) — no se ha movido dinero real todavía.
|
||||
|
||||
## 2. Envío — EnvíoClick reemplaza la tarifa fija
|
||||
|
||||
El ADR 0009 (nota de implementación) dejó una shipping option con tarifa
|
||||
fija de $15.000 COP como **placeholder de negocio**, anotando
|
||||
explícitamente que un cálculo real por peso/volumen era trabajo futuro
|
||||
— "eso es justamente lo que EnvíoClick resolvería más adelante". Este
|
||||
ADR cierra ese punto.
|
||||
|
||||
### Hallazgo de negocio, no técnico, que condiciona la precisión real
|
||||
|
||||
**Ningún producto del catálogo tiene peso ni dimensiones cargados**
|
||||
(confirmado contra la base real: 18 productos activos, 0 con `weight`,
|
||||
0 con `length`). Sin este dato, cualquier cotización real de EnvíoClick
|
||||
no puede ser precisa. Se aceptó como **tarea de datos pendiente, no de
|
||||
código** — la integración usa un paquete de fallback conservador (1 kg,
|
||||
20×20×20 cm) mientras no haya datos reales por producto, documentado en
|
||||
`src/modules/envioclick-fulfillment/types.ts` (`DEFAULT_PACKAGE`).
|
||||
|
||||
### API real, corregida contra la fuente primaria, no contra un plugin de referencia desactualizado
|
||||
|
||||
Un plugin de WordPress usado como primera referencia resultó ser para la
|
||||
**API v1** de EnvíoClick, ya obsoleta. La doc real
|
||||
(`apidoc.envioclickpro.com.co`, generada con apiDoc — se bajó y leyó
|
||||
directo `api_data.json`/`api_project.json`, ya que la SPA no renderizaba
|
||||
sin sesión) reveló diferencias reales, confirmadas con una llamada real
|
||||
exitosa:
|
||||
|
||||
| | Plugin de referencia (v1, desactualizado) | API real (v2, confirmada en vivo) |
|
||||
|---|---|---|
|
||||
| Base URL | `api.envioclickpro.com` | `https://api.envioclickpro.com.co/api/v2` |
|
||||
| Header de auth | `AuthorizationKey: <key>` | `Authorization: <key>` (sin prefijo) |
|
||||
|
||||
`POST /quotation` devolvió en vivo tarifas reales de PIBOX, COORDINADORA,
|
||||
ENVIA, RAPPI y TCC para una cotización de prueba real — se toma
|
||||
`flete + minimumInsurance` (seguro mínimo obligatorio, hay que sumarlo al
|
||||
flete para el precio real a cobrar) más barato del array `data.rates[]`,
|
||||
mismo criterio de "más económico" que ya usaba el plugin de referencia.
|
||||
|
||||
### Hallazgo crítico de Medusa, evitado antes de romper nada (no un incidente real)
|
||||
|
||||
Leyendo directo `@medusajs/utils/dist/common/define-config.js` (no
|
||||
documentación): `defineConfig()` ya registra por defecto
|
||||
`Modules.FULFILLMENT` con el provider `manual_manual`, aunque
|
||||
`medusa-config.ts` no lo mencione explícitamente. `transformModules()`
|
||||
indexa por `serviceName` y el último bloque que se declara **pisa**, no
|
||||
suma, al anterior. Agregar un bloque de fulfillment propio sin incluir
|
||||
también `@medusajs/medusa/fulfillment-manual` adentro habría roto el
|
||||
fulfillment manual existente en silencio — mismo tipo de riesgo que casi
|
||||
pasó con `payment` en el ADR 0009, evitado leyendo el código fuente real
|
||||
antes de escribir el bloque nuevo (ambos providers conviven hoy en el
|
||||
mismo bloque de `medusa-config.ts`).
|
||||
|
||||
**Implementación** (`commerce-backend/src/modules/envioclick-fulfillment/`,
|
||||
`src/lib/envioclick.ts`): `AbstractFulfillmentProviderService`,
|
||||
`calculatePrice()` invocado en vivo cada vez que el carrito refresca
|
||||
shipping options (Medusa advierte que si este método falla, **bloquea el
|
||||
checkout** — el fallback conservador de arriba existe también por esto,
|
||||
no solo por falta de datos). `createFulfillment()` genera la guía real vía
|
||||
`/shipment` (o `/shipment_sandbox` en modo prueba —
|
||||
**el único endpoint con sandbox real**, la cotización siempre usa
|
||||
tarifas reales). Sin cambios en el storefront: `GET /store/shipping-options`
|
||||
nativo de Medusa ya invocaba `calculatePrice()` automáticamente para
|
||||
cualquier shipping option `price_type: "calculated"`.
|
||||
|
||||
**Verificado en vivo (2026-09):**
|
||||
- Shipping option "Envío nacional estándar" migrada de `manual_manual`/
|
||||
tarifa fija a `envioclick_standard`/`calculated` vía Admin API (con
|
||||
usuario admin temporal, eliminado después de usarlo).
|
||||
- Un `400` inicial (`"Providers (envioclick_standard) are not enabled
|
||||
for the service location"`) se resolvió vinculando el provider a la
|
||||
stock location (`POST /admin/stock-locations/:id/fulfillment-providers`)
|
||||
— Medusa exige esto además del bloque de módulo.
|
||||
- Carrito de prueba real con dirección → `shipping_total: 8941` COP,
|
||||
tarifa real de EnvíoClick, no el fijo de $15.000.
|
||||
- Datos reales de la bodega de origen cargados (dirección `Cra 100
|
||||
#42-65`, contacto `cristiancruz29@outlook.com` / `3014750823`) tanto en
|
||||
el ConfigMap (`ENVIOCLICK_ORIGIN_*`) como en el registro real de la
|
||||
stock location en Medusa (antes: "Sin dirección física registrada").
|
||||
- El comercio está en modo **sandbox** de EnvíoClick
|
||||
(`ENVIOCLICK_SANDBOX: "true"`) — las guías que se generan son de
|
||||
prueba, sin costo; ninguna cotización es de prueba (no existe sandbox
|
||||
de cotización).
|
||||
|
||||
**Limitaciones conocidas y aceptadas, no bloqueantes:**
|
||||
- `createReturnFulfillment` tira "no implementado" — devoluciones fuera
|
||||
de alcance.
|
||||
- Cancelación de guía real (`POST cancellation/batch/order`, hasta 50 por
|
||||
lote, usando los `idOrder` que devuelve `/shipment`) confirmada como
|
||||
existente en la API pero **no implementada en el módulo** — se
|
||||
descubrió durante la investigación, no se integró por no ser parte del
|
||||
flujo de checkout mínimo.
|
||||
- Solo EnvíoClick como provider — no hay selección de múltiples
|
||||
couriers por el comprador (v1 siempre toma el más barato).
|
||||
- Ningún producto tiene peso/dimensiones reales — ver arriba.
|
||||
|
||||
## 3. Storefront — banner dinámico y buscador
|
||||
|
||||
Con ambas integraciones ya en producción, se atendieron dos pedidos de
|
||||
UI del storefront relacionados con la experiencia de compra real:
|
||||
|
||||
### 3.1 Banner dinámico (`components/home/hero-carousel.tsx`)
|
||||
|
||||
Antes: tres slides con copy e imágenes fijas, hardcodeadas en el
|
||||
componente, sin relación con el catálogo real. Ahora: `HomePage`
|
||||
(`app/page.tsx`, que ya hace `getProducts()` del backend real) le pasa al
|
||||
carrusel los productos marcados como `featured` en el admin (o, si no hay
|
||||
ninguno, los mismos "tesoros" —nuevos o destacados— que ya usa la sección
|
||||
de abajo, para no duplicar el criterio de selección); el carrusel arma
|
||||
cada slide con la imagen, nombre, precio (`priceLabel`) y link reales del
|
||||
producto, calculando el badge de descuento (`% OFF`) cuando
|
||||
`compareAtPrice` existe. Si la tienda no tuviera ningún producto activo
|
||||
(caso borde), cae a un slide estático de respaldo para no romper la
|
||||
página. Autoplay, dots de paginación y animación quedan igual — solo
|
||||
cambia el origen de los datos.
|
||||
|
||||
### 3.2 Buscador (`components/layout/navbar.tsx`)
|
||||
|
||||
El header en mobile competía el buscador con el logo y los tres iconos
|
||||
de acción en una sola fila de grid (`grid-cols-[auto_1fr_auto]`),
|
||||
quedando visualmente recortado — reportado por el usuario junto a una
|
||||
captura de referencia del header mobile de Best Buy (fila de iconos
|
||||
arriba, buscador a todo el ancho debajo, con micrófono y escaneo QR
|
||||
inline).
|
||||
|
||||
**Decisión:** adoptar el mismo patrón de dos filas en mobile/tablet
|
||||
(logo + iconos arriba, buscador a todo el ancho debajo) pero **sin** los
|
||||
íconos de micrófono/QR — no hay búsqueda por voz ni por código de barras
|
||||
implementada, y un ícono sin función real confunde más de lo que ayuda.
|
||||
En desktop (`lg:` y arriba) se mantuvo la fila única original del grid
|
||||
`[auto_1fr_auto]`: ahí ya sobraba espacio horizontal y partirla en dos
|
||||
solo alargaría el header sin necesidad. Sin cambios en la lógica de
|
||||
`PredictiveSearch` (autocompletado, debounce, navegación) — solo se
|
||||
reubicó su contenedor según el breakpoint.
|
||||
|
||||
## Opciones consideradas (pago)
|
||||
|
||||
| Opción | A favor | En contra |
|
||||
|---|---|---|
|
||||
| PayU LatAm (ADR 0009) | Ya decidido, credenciales bien documentadas | Registro real redirige a Rapyd — la entidad "PayU LatAm" independiente ya no existe para un comercio nuevo |
|
||||
| Rapyd | Dueño real del negocio ex-PayU LatAm, API moderna y bien documentada | API completamente distinta (HMAC, REST moderno) — no es una migración de credenciales, es una integración nueva desde cero; descartada en fase de plan por costo/encaje frente a ePayco |
|
||||
| **ePayco** — elegido | 100% Davivienda desde 2024, mejor tarifa PSE con el banco ya disponible del comercio; SDK oficial cubre el protocolo inusual (login + cifrado AES por campo) | Dos productos bajo la misma marca (Apify vs. la API real usada) fáciles de confundir; doc pública desactualizada respecto al SDK real; reembolsos no implementados |
|
||||
|
||||
## Consecuencias
|
||||
|
||||
- Checkout real de punta a punta (pago + envío calculado) queda
|
||||
desplegado y verificado a nivel API/backend, pero **ambos proveedores
|
||||
siguen en modo sandbox** — no se ha completado ni un pago real ni un
|
||||
envío real todavía. Ver checklist de pruebas abajo.
|
||||
- La precisión de la tarifa de envío depende de cargar peso/dimensiones
|
||||
reales por producto — deuda de datos explícita, no de código; candidato
|
||||
natural a extender el importador CSV existente con columnas nuevas.
|
||||
- Reembolsos (ePayco) y devoluciones/cancelación de guía (EnvíoClick)
|
||||
quedan fuera de alcance — fallan explícitamente en vez de fingir éxito.
|
||||
- Revertir el pago implica deshabilitar el provider `epayco_pse` en la
|
||||
región y volver al placeholder anterior; revertir el envío implica
|
||||
volver la shipping option a `manual_manual`/tarifa fija — ninguna de
|
||||
las dos requiere cambios de esquema de datos para revertirse.
|
||||
- El banner y el buscador no introducen dependencias nuevas ni cambian
|
||||
ninguna ruta de API — son cambios de storefront puros, reversibles
|
||||
cambiando los dos componentes de vuelta a su versión anterior.
|
||||
|
||||
## Checklist de pruebas reales desde el storefront (pendiente, no ejecutado en este ADR)
|
||||
|
||||
Todo lo de arriba se verificó a nivel API/backend con llamadas directas
|
||||
o carritos de prueba armados por API — **no** todavía manejando el
|
||||
storefront real como lo haría un comprador. Pendiente, con la próxima
|
||||
sesión que tenga acceso a un navegador real:
|
||||
|
||||
1. **Pago PSE completo:** agregar un producto real al carrito → checkout
|
||||
→ elegir PSE → seleccionar un banco del listado real (sandbox) →
|
||||
confirmar que la redirección al banco ocurre (esto es justo lo que
|
||||
nunca se probó — el nombre del campo de URL de `bank.create()` está
|
||||
manejado a la defensiva y podría no matchear ningún candidato) →
|
||||
volver a `/checkout/pse/return` → confirmar que la orden queda en
|
||||
estado correcto.
|
||||
2. **Envío calculado real:** en el paso de dirección del checkout,
|
||||
confirmar que el precio de envío mostrado ya no es el fijo de
|
||||
$15.000 sino el que devuelve EnvíoClick en vivo para esa dirección
|
||||
(visible también sin completar el pago, solo llegando al paso de
|
||||
shipping).
|
||||
3. **Resiliencia del fallback de envío:** si es posible, forzar una
|
||||
dirección o producto que haga fallar la cotización real (por ejemplo,
|
||||
un DANE code inválido) y confirmar que el checkout sigue avanzando
|
||||
con el precio de respaldo en vez de romperse — el comportamiento
|
||||
documentado en `calculatePrice()`, nunca ejercitado con un fallo real.
|
||||
4. **Banner dinámico:** confirmar en `/` que el carrusel muestra
|
||||
productos reales del catálogo (no las tres imágenes viejas
|
||||
hardcodeadas) y que cada slide lleva al producto correcto al hacer
|
||||
clic.
|
||||
5. **Buscador:** en un viewport mobile real (no solo devtools), confirmar
|
||||
que el buscador ya no se ve recortado y que el autocompletado
|
||||
despliega bien debajo de la fila nueva a todo el ancho.
|
||||
6. **Webhook de ePayco con un pago real de sandbox:** confirmar que,
|
||||
tras completar un pago PSE de prueba desde el banco sandbox, el
|
||||
webhook mueve la orden a completada sin intervención manual (hoy solo
|
||||
se confirmó que el endpoint responde `200` a un `POST` sintético, no
|
||||
con un webhook real disparado por ePayco).
|
||||
@@ -18,7 +18,13 @@ export const dynamic = "force-dynamic";
|
||||
export default async function HomePage() {
|
||||
const [products, categories] = await Promise.all([getProducts(), getCategories()]);
|
||||
const treasures = products.filter((product) => product.isNew || product.featured).slice(0, 8);
|
||||
return <><HeroCarousel /><TrustBar /><div className="content-auto"><CategoryTiles categories={categories} /></div><section className="content-auto mx-auto max-w-7xl px-4 py-14"><div className="mb-8 flex items-end justify-between gap-5"><div><span className="text-xs font-black uppercase tracking-[.18em] text-ari-coral">Novedades</span><h2 className="mt-2 text-4xl font-black tracking-tight sm:text-5xl">Tesoros recién llegados</h2><p className="mt-3 text-slate-500">Desliza y encuentra nuevos favoritos.</p></div><Button asChild variant="outline" className="hidden sm:inline-flex"><Link href="/catalog">Ver catálogo <ArrowRight className="size-4" /></Link></Button></div><ProductCarousel products={treasures} /></section><section className="content-auto mx-auto max-w-7xl px-4 pb-20"><div className="grid overflow-hidden rounded-[2rem] bg-ari-marino text-white shadow-2xl lg:grid-cols-[1fr_.7fr]"><div className="p-8 sm:p-12"><span className="text-xs font-black uppercase tracking-[.18em] text-ari-coral-claro">Club ARI</span><h2 className="mt-3 text-4xl font-black tracking-tight sm:text-6xl">Promociones, lanzamientos y mucha diversión.</h2><p className="mt-5 max-w-xl text-white/80">Únete a nuestra comunidad y recibe primero las novedades del catálogo.</p><Button variant="yellow" size="lg" className="mt-7">Quiero unirme</Button></div>{/* No hay herramienta de generacion de imagenes disponible para crear un
|
||||
// ADR 0010: el banner toma primero productos destacados (curaduria
|
||||
// explicita del admin via el flag "featured"); si no hay ninguno,
|
||||
// cae a los mismos "tesoros" (nuevos/destacados) de la seccion de
|
||||
// abajo para no repetir la logica de seleccion.
|
||||
const featuredProducts = products.filter((product) => product.featured);
|
||||
const bannerProducts = featuredProducts.length > 0 ? featuredProducts : treasures;
|
||||
return <><HeroCarousel products={bannerProducts} /><TrustBar /><div className="content-auto"><CategoryTiles categories={categories} /></div><section className="content-auto mx-auto max-w-7xl px-4 py-14"><div className="mb-8 flex items-end justify-between gap-5"><div><span className="text-xs font-black uppercase tracking-[.18em] text-ari-coral">Novedades</span><h2 className="mt-2 text-4xl font-black tracking-tight sm:text-5xl">Tesoros recién llegados</h2><p className="mt-3 text-slate-500">Desliza y encuentra nuevos favoritos.</p></div><Button asChild variant="outline" className="hidden sm:inline-flex"><Link href="/catalog">Ver catálogo <ArrowRight className="size-4" /></Link></Button></div><ProductCarousel products={treasures} /></section><section className="content-auto mx-auto max-w-7xl px-4 pb-20"><div className="grid overflow-hidden rounded-[2rem] bg-ari-marino text-white shadow-2xl lg:grid-cols-[1fr_.7fr]"><div className="p-8 sm:p-12"><span className="text-xs font-black uppercase tracking-[.18em] text-ari-coral-claro">Club ARI</span><h2 className="mt-3 text-4xl font-black tracking-tight sm:text-6xl">Promociones, lanzamientos y mucha diversión.</h2><p className="mt-5 max-w-xl text-white/80">Únete a nuestra comunidad y recibe primero las novedades del catálogo.</p><Button variant="yellow" size="lg" className="mt-7">Quiero unirme</Button></div>{/* No hay herramienta de generacion de imagenes disponible para crear un
|
||||
asset nuevo -- se reconstruye el mismo efecto (fondo punteado +
|
||||
fotos estilo polaroid) con CSS y fotos reales de producto ya
|
||||
existentes, en azul/amarillo de marca en vez del violeta original
|
||||
|
||||
@@ -33,3 +33,18 @@ data:
|
||||
EPAYCO_ENV: sandbox
|
||||
EPAYCO_RESPONSE_URL: https://shop.cruzcloud.net/checkout/pse/return
|
||||
EPAYCO_NOTIFY_URL: https://commerce.cruzcloud.net/hooks/payment/epayco_pse
|
||||
|
||||
# EnvíoClick (ADR 0009 §2) -- fulfillment provider real por peso/volumen,
|
||||
# reemplaza la tarifa fija. Solo config no sensible; ENVIOCLICK_API_KEY
|
||||
# va en secrets.template.yaml. ENVIOCLICK_SANDBOX=true usa el endpoint
|
||||
# de guía de pruebas (/shipment_sandbox) -- la cotización siempre usa
|
||||
# tarifas reales, no tiene modo sandbox. Origen = bodega Bogotá
|
||||
# ("Bodega principal ARI Shopping", sin dirección física real cargada
|
||||
# todavía -- ENVIOCLICK_ORIGIN_ADDRESS es un placeholder hasta que la
|
||||
# haya).
|
||||
ENVIOCLICK_SANDBOX: "true"
|
||||
ENVIOCLICK_ORIGIN_DANE_CODE: "11001000"
|
||||
ENVIOCLICK_ORIGIN_ADDRESS: "Cra 100 #42-65"
|
||||
ENVIOCLICK_ORIGIN_COMPANY: "ARI Shopping"
|
||||
ENVIOCLICK_ORIGIN_EMAIL: "[email protected]"
|
||||
ENVIOCLICK_ORIGIN_PHONE: "3014750823"
|
||||
@@ -65,7 +65,7 @@ spec:
|
||||
memory: 64Mi
|
||||
|
||||
- name: migrations
|
||||
image: gitea.cruzcloud.net/devops/ecommerce-medusa:v1.0.227
|
||||
image: gitea.cruzcloud.net/devops/ecommerce-medusa:v1.0.234
|
||||
imagePullPolicy: IfNotPresent
|
||||
command:
|
||||
- node
|
||||
@@ -86,7 +86,7 @@ spec:
|
||||
|
||||
containers:
|
||||
- name: app
|
||||
image: gitea.cruzcloud.net/devops/ecommerce-medusa:v1.0.227
|
||||
image: gitea.cruzcloud.net/devops/ecommerce-medusa:v1.0.234
|
||||
imagePullPolicy: IfNotPresent
|
||||
envFrom:
|
||||
- configMapRef:
|
||||
|
||||
@@ -47,6 +47,10 @@ stringData:
|
||||
EPAYCO_PRIVATE_KEY: CAMBIAR
|
||||
EPAYCO_P_CUST_ID_CLIENTE: CAMBIAR
|
||||
EPAYCO_P_KEY: CAMBIAR
|
||||
|
||||
# EnvíoClick (ADR 0009 §2) -- API key real de la cuenta
|
||||
# (envioclickpro.com.co > API Key / Desarrolladores).
|
||||
ENVIOCLICK_API_KEY: CAMBIAR
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: Secret
|
||||
|
||||
@@ -88,6 +88,12 @@ export function CheckoutClient() {
|
||||
address1: form.address1,
|
||||
city: selectedCiudad.name,
|
||||
province: selectedDepartamento.name,
|
||||
// ids DIVIPOLA reales -- EnvioClick (fulfillment provider) los
|
||||
// necesita para cotizar sin ambiguedad, el nombre solo no
|
||||
// alcanza (hay municipios con el mismo nombre en distintos
|
||||
// departamentos).
|
||||
cityId: selectedCiudad.id,
|
||||
departmentId: selectedDepartamento.id,
|
||||
phone: form.phone,
|
||||
email: form.email,
|
||||
});
|
||||
|
||||
@@ -4,15 +4,33 @@ import Image from "next/image";
|
||||
import Link from "next/link";
|
||||
import { ArrowRight, BadgePercent, Sparkles } from "lucide-react";
|
||||
import { AnimatePresence, motion, useReducedMotion } from "motion/react";
|
||||
import { useEffect, useState } from "react";
|
||||
import { useEffect, useMemo, useState } from "react";
|
||||
import { Button } from "@/components/ui/button";
|
||||
import type { Product } from "@/lib/headless/types";
|
||||
|
||||
// ADR 0008 sub-fase 4: hero azul con dots de paginacion (carrusel), en vez
|
||||
// del bento estatico de 3 tarjetas en fucsia/rojo/violeta del esquema
|
||||
// arcoiris original. Un slide a la vez, fondo azul de marca en los tres,
|
||||
// para leerse como una sola pieza de marca en vez de 3 bloques de colores
|
||||
// distintos.
|
||||
const slides = [
|
||||
//
|
||||
// ADR 0010: los slides ya no son un array hardcodeado -- se derivan de
|
||||
// productos activos reales del catalogo (pasados por prop desde
|
||||
// app/page.tsx, que ya trae `products` del backend). Fallback estatico
|
||||
// solo para el caso borde de una tienda sin ningun producto activo.
|
||||
type Slide = {
|
||||
id: string;
|
||||
badge: string;
|
||||
icon: typeof Sparkles;
|
||||
title: string;
|
||||
subtitle: string;
|
||||
description: string;
|
||||
href: string;
|
||||
image: string;
|
||||
imageAlt: string;
|
||||
};
|
||||
|
||||
const FALLBACK_SLIDES: Slide[] = [
|
||||
{
|
||||
id: "celebracion",
|
||||
badge: "Celebración ARI",
|
||||
@@ -48,17 +66,46 @@ const slides = [
|
||||
},
|
||||
];
|
||||
|
||||
const MAX_SLIDES = 5;
|
||||
const AUTOPLAY_MS = 6000;
|
||||
|
||||
export function HeroCarousel() {
|
||||
function slidesFromProducts(products: Product[]): Slide[] {
|
||||
return products.slice(0, MAX_SLIDES).map((product) => {
|
||||
const hasDiscount = product.compareAtPrice !== null && product.compareAtPrice > (product.price ?? 0);
|
||||
const pctOff = hasDiscount && product.price !== null
|
||||
? Math.round(100 - (product.price / (product.compareAtPrice as number)) * 100)
|
||||
: 0;
|
||||
return {
|
||||
id: product.id,
|
||||
badge: hasDiscount ? `${pctOff}% OFF` : product.collection ? `Colección ${product.collection}` : "Destacado",
|
||||
icon: hasDiscount ? BadgePercent : Sparkles,
|
||||
title: product.name,
|
||||
subtitle: product.priceLabel,
|
||||
description: product.shortDescription || "Descúbrelo en la tienda ARI Shopping.",
|
||||
href: `/product/${product.slug}`,
|
||||
image: product.image,
|
||||
imageAlt: product.name,
|
||||
};
|
||||
});
|
||||
}
|
||||
|
||||
export function HeroCarousel({ products }: { products: Product[] }) {
|
||||
const reduceMotion = useReducedMotion();
|
||||
const [index, setIndex] = useState(0);
|
||||
const slides = useMemo(() => {
|
||||
const fromProducts = slidesFromProducts(products);
|
||||
return fromProducts.length > 0 ? fromProducts : FALLBACK_SLIDES;
|
||||
}, [products]);
|
||||
|
||||
useEffect(() => {
|
||||
if (reduceMotion) return;
|
||||
const timer = setInterval(() => setIndex((current) => (current + 1) % slides.length), AUTOPLAY_MS);
|
||||
return () => clearInterval(timer);
|
||||
}, [reduceMotion]);
|
||||
}, [reduceMotion, slides.length]);
|
||||
|
||||
useEffect(() => {
|
||||
if (index >= slides.length) setIndex(0);
|
||||
}, [slides.length, index]);
|
||||
|
||||
const slide = slides[index];
|
||||
if (!slide) return null;
|
||||
|
||||
@@ -55,34 +55,47 @@ export function Navbar({ products, categories }: { products: Product[]; categori
|
||||
|
||||
<div className="relative overflow-visible bg-white">
|
||||
<div className="pointer-events-none absolute inset-x-0 top-0 h-1 bg-ari-coral-claro" />
|
||||
<div className="mx-auto grid max-w-7xl grid-cols-[auto_1fr_auto] items-center gap-4 px-4 py-4 lg:gap-8">
|
||||
{/* Isotipo circular con icono + wordmark integrados (como en la
|
||||
version previa a ADR 0008), pedido explicito del usuario en
|
||||
vez del lockup rectangular. logo-ari.svg (rectangular) se
|
||||
mantiene para el footer. */}
|
||||
<Link href="/" aria-label="ARI shopping" className="shrink-0">
|
||||
{/* eslint-disable-next-line @next/next/no-img-element -- vector propio, next/image no optimiza SVG sin habilitar dangerouslyAllowSVG */}
|
||||
<img src="/images/brand/logo-ari-circular.svg" alt="ARI shopping" className="size-16 lg:size-20" width={200} height={200} />
|
||||
</Link>
|
||||
<PredictiveSearch />
|
||||
<div className="flex items-center gap-2">
|
||||
{/* Antes escondido en mobile (solo alcanzable desde el menu
|
||||
hamburguesa) -- pedido explicito del usuario: visible
|
||||
siempre en el header, con un punto verde cuando hay sesion
|
||||
iniciada (mismo patron que el badge de cantidad del
|
||||
carrito/favoritos, pero de presencia, no de conteo). */}
|
||||
<Button variant="outline" size="icon" aria-label={isLoggedIn ? "Mi cuenta (sesión iniciada)" : "Mi cuenta"} className="relative inline-flex border-slate-300 bg-white text-slate-900 hover:border-ari-coral hover:bg-ari-coral/10" onClick={() => setAccountOpen(true)}>
|
||||
<UserRound />
|
||||
{isLoggedIn && <span className="absolute -right-1 -top-1 size-3 rounded-full border-2 border-white bg-emerald-500" />}
|
||||
</Button>
|
||||
<Button variant="outline" size="icon" aria-label={`Favoritos: ${wishlistCount}`} className="relative hidden border-slate-300 bg-white text-slate-900 hover:border-ari-coral hover:bg-ari-coral/10 sm:inline-flex" onClick={openWishlist}>
|
||||
<Heart />
|
||||
{wishlistCount > 0 && <span className="absolute -right-1.5 -top-1.5 grid size-5 place-items-center rounded-full bg-ari-marino text-[10px] font-black text-white">{wishlistCount}</span>}
|
||||
</Button>
|
||||
<Button variant="primary" size="icon" onClick={openCart} aria-label={`Carrito con ${count} productos`} className="relative">
|
||||
<ShoppingCart />
|
||||
<span className="absolute -right-2 -top-2 grid size-6 place-items-center rounded-full bg-ari-marino text-[11px] font-black text-white">{count}</span>
|
||||
</Button>
|
||||
{/* ADR 0010: en mobile/tablet el buscador se movio a una segunda
|
||||
fila a todo el ancho, debajo de logo+iconos (antes competia por
|
||||
espacio en una sola fila con el grid_[auto_1fr_auto] y quedaba
|
||||
angosto/recortado). En desktop (lg+) se mantiene la fila unica
|
||||
original -- ahi sobra espacio y partirla en dos solo alargaria
|
||||
el header sin necesidad. */}
|
||||
<div className="mx-auto max-w-7xl px-4 py-3 lg:py-4">
|
||||
<div className="flex items-center justify-between gap-4 lg:grid lg:grid-cols-[auto_1fr_auto] lg:gap-8">
|
||||
{/* Isotipo circular con icono + wordmark integrados (como en la
|
||||
version previa a ADR 0008), pedido explicito del usuario en
|
||||
vez del lockup rectangular. logo-ari.svg (rectangular) se
|
||||
mantiene para el footer. */}
|
||||
<Link href="/" aria-label="ARI shopping" className="shrink-0">
|
||||
{/* eslint-disable-next-line @next/next/no-img-element -- vector propio, next/image no optimiza SVG sin habilitar dangerouslyAllowSVG */}
|
||||
<img src="/images/brand/logo-ari-circular.svg" alt="ARI shopping" className="size-16 lg:size-20" width={200} height={200} />
|
||||
</Link>
|
||||
<div className="hidden lg:block">
|
||||
<PredictiveSearch />
|
||||
</div>
|
||||
<div className="flex items-center gap-2">
|
||||
{/* Antes escondido en mobile (solo alcanzable desde el menu
|
||||
hamburguesa) -- pedido explicito del usuario: visible
|
||||
siempre en el header, con un punto verde cuando hay sesion
|
||||
iniciada (mismo patron que el badge de cantidad del
|
||||
carrito/favoritos, pero de presencia, no de conteo). */}
|
||||
<Button variant="outline" size="icon" aria-label={isLoggedIn ? "Mi cuenta (sesión iniciada)" : "Mi cuenta"} className="relative inline-flex border-slate-300 bg-white text-slate-900 hover:border-ari-coral hover:bg-ari-coral/10" onClick={() => setAccountOpen(true)}>
|
||||
<UserRound />
|
||||
{isLoggedIn && <span className="absolute -right-1 -top-1 size-3 rounded-full border-2 border-white bg-emerald-500" />}
|
||||
</Button>
|
||||
<Button variant="outline" size="icon" aria-label={`Favoritos: ${wishlistCount}`} className="relative hidden border-slate-300 bg-white text-slate-900 hover:border-ari-coral hover:bg-ari-coral/10 sm:inline-flex" onClick={openWishlist}>
|
||||
<Heart />
|
||||
{wishlistCount > 0 && <span className="absolute -right-1.5 -top-1.5 grid size-5 place-items-center rounded-full bg-ari-marino text-[10px] font-black text-white">{wishlistCount}</span>}
|
||||
</Button>
|
||||
<Button variant="primary" size="icon" onClick={openCart} aria-label={`Carrito con ${count} productos`} className="relative">
|
||||
<ShoppingCart />
|
||||
<span className="absolute -right-2 -top-2 grid size-6 place-items-center rounded-full bg-ari-marino text-[11px] font-black text-white">{count}</span>
|
||||
</Button>
|
||||
</div>
|
||||
</div>
|
||||
<div className="mt-3 lg:hidden">
|
||||
<PredictiveSearch />
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -25,7 +25,7 @@ spec:
|
||||
runAsUser: 1001
|
||||
containers:
|
||||
- name: app
|
||||
image: gitea.cruzcloud.net/devops/ecommerce-frontend:v1.0.228
|
||||
image: gitea.cruzcloud.net/devops/ecommerce-frontend:v1.0.235
|
||||
env:
|
||||
- name: HEADLESS_PROVIDER
|
||||
value: medusa
|
||||
|
||||
@@ -46,6 +46,14 @@ export interface ShippingAddressInput {
|
||||
province?: string;
|
||||
phone: string;
|
||||
email: string;
|
||||
// ids DIVIPOLA/DANE reales (lib/data/colombia.ts) -- se guardan en la
|
||||
// metadata de la direccion porque Medusa no tiene un campo propio para
|
||||
// esto. EnvioClick (fulfillment provider real, ver ADR 0009 §2) los
|
||||
// necesita para cotizar/generar guia sin ambiguedad -- el nombre de
|
||||
// ciudad solo no alcanza (hay nombres de municipio repetidos entre
|
||||
// distintos departamentos en Colombia).
|
||||
cityId?: number;
|
||||
departmentId?: number;
|
||||
}
|
||||
|
||||
export interface ShippingOption {
|
||||
@@ -212,6 +220,10 @@ export async function setShippingAddress(
|
||||
province: address.province || undefined,
|
||||
country_code: "co",
|
||||
phone: address.phone,
|
||||
metadata:
|
||||
address.cityId || address.departmentId
|
||||
? { cityId: address.cityId, departmentId: address.departmentId }
|
||||
: undefined,
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
Reference in new issue
Block a user