Integration: Dimensions and Unit of Measurement - ChrisMavrommatis/Binacle.Net GitHub Wiki

Contents

Integrating with Binacle.Net requires careful attention to dimensions and units of measurement. This process is crucial and may be one of the most detailed tasks during integration. Below are the key steps to ensure accuracy and consistency throughout the integration process.

Measurement Unit

By default, Binacle.Net uses centimeters as the unit of measurement. While other units can be used, they must be integers and follow the same principles. To avoid unnecessary complications, it’s recommended to stick with centimeters.

Consistent Dimensions

Ensure that all product dimensions are accurate and consistent. Binacle.Net assumes all items are rectangular prisms (3D rectangles), so measurements should reflect this shape. Irregular shapes are not supported.

Conversion Considerations

If your current measurements are in a different unit (e.g., millimeters), it’s advisable to convert them to centimeters. You can either store the converted measurements or handle the conversion dynamically during operations.

Weight Considerations

Though Binacle.Net does not account for weight, many locker providers impose weight limits. Consider the following:

  • Verify weight limits set by locker providers.
  • Ensure your backend tracks product weight.
  • Implement logic to prevent selecting lockers that exceed weight capacity.
  • Inform users of any weight-related restrictions during checkout to avoid issues.

Additional Tips

  • Accuracy: Ensure measurement accuracy to optimize packing and avoid errors.
  • Automation: Automate conversion processes to maintain consistency and reduce manual work.
  • Standardization: Standardize measurement input across systems to avoid discrepancies.
  • Use Maximum Measurements: When measuring items, always use the maximum dimensions to account for slight variations or irregularities. This helps prevent errors where a package may be marginally larger than expected.

Conclusion

Attention to these details will ensure a smooth integration with Binacle.Net, helping you optimize packing efficiency and meet shipping requirements seamlessly.